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Course Synopsis - 64120T 

□ 



INTRODUCTION FOR STUDENTS 

A brief synopsis of the 64000-UX Overview Course is given below: 



Course Name: 
Course Number 
Objective: 



Content: 



Format: 
Duration: 

Number of Students: 
Products Covered: 

Prerequisite: 

Location: 

Options: 



HP 64000-UX Overview Course 
641 201 

Provide the student with the basics of the 
64000-UX system. The student should gain 
enough practical information through the 
course labs to "come up to speed" on the 
64000-UX system and emulation. 

An overview of the 64000-UX system including: 
access to the computer, the User Interface 
Software (pmon),the Soft key Driven Editor 
(Sk), command files, the 64000-UX language 
tools, concepts of measurement systems, 
hardware option test, philosophy of 
emulation, and emulation based on the 
Motorola 68000. 

Lecture (45%) / Lab (50%) / Overhead (5%) 
2 days 

8 MAXIMUM 

641 20A, 64801S, 64808S, 6.4790S, 64243S, 64302A, 
648 15S, 648 19S, 64845S 

No prerequisite required 

HP sales office or Training Center 

None 
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INTRODUCTION FOR STUDENTS 

A brief synopsis of the 64000-UX Overview Course is given below: 



Course Name: 
Course Number: 
Objective: 



Content: 



Format: 
Duration: 

Number of Students: 
Products Covered: 

Prerequisite: 

Location: 

Options: 



HP 64000-UX Overview Course 
64120X 

Provide the student with the basics of the 
64000-UX system. The student should gain 
enough practical information through the 
course labs to "come up to speed" on the 
64000-UX system and emulation. 

An overview of the 64000-UX system including: 
access to the computer, the User Interface 
Software (pmon),the Softkey Driven Editor 
(Sk), command files, the 64000-UX language 
tools, concepts of measurement systems, 
hardware option test, philosophy of 
emulation, and emulation based on the 
Motorola 68000. 

Lecture (45%) / Lab (50%) / Overhead (5%) 
2 days 

8 MAXIMUM 

641 20A, 64801S, 64808S, 64790S, 64243S, 64302A, 
648 15S, 648 19S, 64845S 

No prerequisite required 

Customer Site 

641 20X #001 - Add One Student On-site 
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SUGGESTED COURSE SCHEDULE: 

The schedule shown below is only a suggested schedule. The actual amount of time spent on each section 
will have to be determined by the instructor depending upon the customer's needs. The amount of on-hands 
lab time should not be altered, or the effectiveness of the training course will be compromised. 



HP 64000-UX Training Course Day 1 



8:00-8:10 


(1) 


Course Introduction 


8:10-8:20 


(2) 


System Introduction 


8:20-8:50 


(3) 


User Interface Software (pmon) 


8:50-8:55 


(4) 


HELP!! 


8:55-9:25 


(5) 


System Introduction Lab 


9:25-9:35 




Break 


9:35-10:05 


(6) 


Editors 


10:05-10:35 


(7) 


Command Files 


10:35-12:00 


(8) 


Editor / Command Files Lab 


12:00-1:00 




Lunch 


1:00-1:10 


(9) 


HP 64000-UX Language System 


1:10-1:40 


(10) 


Assemblers 


1:40-2:10 


(11) 


Compilers 


2:10-2:20 




Break 


2:20-2:50 


(12) 


Linkers 


2:50-3:00 


(13) 


Language System Summary 


3:00-5:00 


(14) 


Assemblers / Compilers / Linkers Lab 


HP 64000-UX Training Course 


Day 2 


8:00-9:00 


(15) 


Measurement Systems 


9:00-9:30 


(16) 


Measurement Systems Lab 


9:30-9:40 




Break 


9:40-1 1:30 


(17) 


Introduction to Emulation 


1 1:30-12:30 




Lunch 


12:30-2:00 


(18) 


Emulation Lab 


2:00-2:10 




Break 


2:10-4:30 


(18) 


Emulation Lab 


4:30-4:45 


(19) 


The 64000-UX Product Line 


4:45-5:00 


(20) 


Course Conclusion 
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COURSE OUTLINE (641 20T): 



HP 64000-UX Overview Course Day 1 

(a) Course Introduction 

(1) general information 
(i) who should attend 

(ii) philosophy of the course 

(iii) course objectives 

(2) knowledge survey 

(i) purpose and use of the survey 
(ii) complete the survey 

(b) System Introduction 

(1) software development process 
(i) idea 

(ii) specify /design phase 
(iii) implement/construct phase 

(iv) test/debug phase 
(v) product 

(2) where does Logic Systems Division fit in? 
(i) specify /design phase 

* learn work SA/SD/RT 
(ii) implement/construct phase 

* Sk and Vi editors 

* assemblers/linkers 

* C/Pascal compilers 

* ADA connection 
(iii) debug/test phase 

* emulators 

* timing/state analyzers 

* software performance analyzer 

* software analyzers 

(c) User Interface Software (pmon) 

(1) purpose 

(2) features / advantages / benefits 

(3) getting started 

(i) entering pmon 
(ii) special features 

* control characters 

* hidden commands 
(iii) softkeys 

* definition 

* terminal keys 

* default pmon screen 

the display screen 
- the STATUS line 
the command lines 
the softkeys 
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Course Outline 



HP 64000-UX Overview Course (cont) Day 1 

(iv) HP-UX command mapping 

* HP-UX /pmon cross referencing 

* entering HP-UX commands 

* gaining access to the shell 
(y) exiting pmon 

(4) command interpretation 

(5) last look at the manual 

(d) HELP!! 

(1) Where is help available? 
(i) HP-UX help 

* on-line manuals for HP-UX commands 

* the HP-UX system manuals 

* help within HP-UX applications: using 
(ii) HP 64000-UX help 

* on-line manuals for HP 64000-UX commands 

* the HP 64000-UX system manuals 

* help within HP 64000-UX applications: "HELP" softkey 

(2) This training course as a source of information 

(e) System Introduction Lab 

(f) Editors 

(1) What is available? 

(i) the HP-UX system visual editor: Vi 

(ii) the HP 64000-UX system full-screen editor: Sk 

(2) a brief look at Vi 

(i) features / advantages / benefits 

(ii) drawbacks / limitations 

(iii) shipped with HP-UX 

(3) an in-depth look at Sk 

(i) features / advantage / benefits 
(ii) drawbacks / limitations 
(iii) ordering information 

(iv) modes of the editor 

* command mode 

* insert mode 

* revise mode 
(v) the editor screen 

* format 

text area 
line numbers 

* status line 

* command line 

* soft keys 



ix 



Course Outline 

□ 



HP 64000-UX Overview Course (cont) Day 1 

(vi) cursor and screen control 
(vii) special keys sequences 

* recalling commands from the command buffer 

* refreshing the screen 

* entering non-printable characters 
(viii) commands of the editor 

* common commands available 

1 unique and advanced commands 
(ix) accessing the editor 

* entering the editor 

* exiting the editor 
(g) Command Files 

(1) definition of command files 

(i) features / advantages / benefits of command files 

(2) what command files are available 

(i) HP-UX command files: shell scripts 

* creating shell scripts 

* using shell scripts 

* parameter passing 

* example shell script: the ".profile" file 
(ii) HP 64000-UX command files 

* creating these command files 

* using these command files 

* parameter passing 

* possible problems using HP 64000-UX command files 

entering errors while creating command files 

* example of pmon command file 

* example of Sk command file 
(i) HP 64000-UX Language System 

(1) features / advantages / benefits 

(2) components of the language system 

(3) source code 

(4) absolute code 
(j) Assemblers 

(1) purpose 

(2) features / advantages / benefits 

(3) functional components 
(i) initialization 

(ii) passl 
(iii) pass2 
(iv) pass3 
(V) pass4 
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HP 64000-UX Overview Course (cont) Day1 

(4) processor directives 
(i) uses and syntax 

(5) output files of the assembler 
(i) relocatable file (.R) 

(ii) symbol file (.A) 
(iii) listing file (X)) 

* options available 

expansion 
cross-referencing 

(6) assembler directives 
(i) function 

(ii) most useful directives 

* ORG 

* END 

(7) transfer address 
(i) definition 

(ii) creation of the transfer address 
(k) Compilers 

(1) purpose of a compiler 

(2) features / advantages / benefits 

(3) functional description 

(i) optional preprocessor 

(ii) passl 

(iii) pass 2 
(iv) pass3 

(4) types of compilers 
(i) native compilers 
(ii) cross compilers 

(5) compiler libraries 

(6) output files of a compiler 

(i) relocatable file (.R) 

(ii) symbol file (.A) 

(iii) listing file (.0) 

* options available 

expansion 
cross-referencing 

(iv) assembly file (ASM68000) 

(7) processor directives 

(i) purpose 

(ii) syntax for C 

(iii) syntax for Pascal 
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□ 



HP 64000-UX Overview Course (cont) Day1 

(8) transfer address 
(i) overview 

(ii) creation of the transfer address in C 

(iii) creation of the transfer address in Pascal 
(I) Linkers 

(1) purpose of a linker 

(2) features / advantages / benefits 

(3) functional components 
(i) initialization 

(ii) passl 

(iii) pass 2 

(iv) cross reference 

(4) output files of a linker 
(i) absolute file ( X) 

(ii) linker symbol file (.L) 

(iii) linker listing file (.O, .MAP files) 

* generation and syntax 

* options 

cross-referencing 

(iv) linker command file (.K) 

* features / advantages / benefits 

* creation 

queries of the linker 
ASCII file generation 
(m) Language System Summary 

(1) file types 

(i) source files 
(ii) relocatable files 
(iii) assembler / compiler symbol files 

(iv) assembler / compiler listing files 

(v) linker symbol file 
(vi) linker listing file 

(vii) linker command file 
(viii) object code or absolute file 

(2) flow diagram of language system 
(n) Assemblers / Compilers / Linkers Lab 
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HP 64000-UX Overview Course Day 2 

(a) Measurement Systems 

(1) manual references 

(i) HP 64000-UX User's Guide 
HP P/N 64801-90903 

(2) definition of a module 

(i) available 64000-UX modules 

(3) definition of a measurement system 
(i) 1MB connection between modules 

(ii) definition of 1MB 

(4) building measurement systems 
(i) nisi nit 

* searching for cardcages 
(ii) msconfig 

(iii) msstat 

* status messages 

available 
unusable 
running 
locked 

(iv) msunlock 

(5) hardware option test 

(i) look at 64120 

* front panel 

* back panel 

(ii) look at module (emulation) 

* boards in module 

* boards configuration in cardcage 

* option test software 

(b) Measurement Systems Lab 

(c) Introduction to Emulation 

(1) what is emulation (definition) 

(2) emulation vs. simulation 

(i) real time execution 

(ii) non-real time execution 

(3) what is transparency 

(i) functional transparency 
(ii) timing transparency 

(iii) electrical transparency 

(4) what is an emulation monitor 
(i) foreground monitors 

(ii) background monitors 

(5) block diagram of emulation 

(i) connection between cards and diagram 

(ii) connection between cables and buses 

(iii) connection between hardware and cardcage 
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Course Outline 
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HP 64000-UX Overview Course (cont) Day 2 

(6) components of emulation 
(i) program loading 
(ii) configuring the emulator 

* default configuration 

* modify configuration 

* clock specification 

* restriction to real time runs 

* illegal opcode detection 

* memory mapping 

break on write to ROM 
default conditions 
processor specific questions 
kinds of memory 

ROM 

RAM 

guarded 
sources of memory 

emulation 

target 
memory overlays 

* pod configuration 

* interactive measurements 

* configuration command files 

(iii) run control 

* run [from] / [until] 

* single stepping 

* break on trigger condition 

* software breakpoints 

* reset (user and system) 

(iv) display / modify commands 

* registers 

* memory 

* symbols 
I/O ports 

(v) edbuikl 

(vi) using analysis with emulation 

* state / timing / spa 

* internal analyzer (64302) 

use with the emulator 
setting trace specifications 
- starting and stopping trace 
displaying trace data 
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HP 64000-UX Overview Course (cont) Day 2 

(vii) simulated I/O (brief discussion of existence) 

* definition of simulated I/O 

* standard input 

* standard output 

* standard error 

* performing simulated I/O 

keyboard 

file (ex. device files) 

* displaying simulated I/O 

(d) Emulation Lab 

(e) The 64000-UX Product Line 

(1) overall picture of the 64000-UX product line 

(2) what training is available for the HP 64000-UX options 

(i) overview of training available from LSD 

(f ) Course Conclusion 

( 1 ) course conclusions 

(i) information the student should know 

(ii) what the student should be able to do with HP 64000-UX 

(2) knowledge survey 

(i) purpose and use of the survey 
(ii) complete the survey 
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COURSE EVALUATIONS BY STUDENTS AND INSTRUCTORS: 

Two types of evaluations for the course need to be filled out by the students. The first is the standard 
course evaluation form supplied by the Application Support Division (ASD) and is read by an op-scan 
machine. The instructor is also required to fill out an evaluation form to be returned to ASD. The front 
page of this evaluation sheet is for general information about the student and an overview of the knowledge 
level of the student in a few general areas. This front page is to be filled out before beginning the course. 
The back page of the evaluation contains generic questions concerning the training course presentation, labs, 
materials, and instructor and should be completed after finishing the course. 

The second type of evaluation sheet is supplied with the course and is meant to be filled out once before (he 
course, and once after the course is complete. The second evaluation or "knowledge survey" will be used to 
determine where the weak points of the course are so that the revisions to the training course can reflect the 
needs of the students. The first of the two knowledge surveys should be completed prior to beginning the 
course and the second copy of the knowledge survey should be completed after finishing the training course. 

All the evaluations should be collected by the instructor and returned to Application Support Division For 
review. 
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Knowledge Survey - Course Preview 
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Course Preview - HP 64000-UX Overview Course - 641 20T 

Before beginning the training course, take a few minutes to indicate how you the student feel about 
performing each of the tasks listed below. Use the table below as a guide to determine what you feel yo<u 
confidence level is for each of the areas specified. Circle your choice and return the completed form to ihr 
course instructor. 

EC - Extremely Confident 

C - Confident 

SC - Somewhat Confident 

NS - Not Sure 

U - Unable 

Your are now able to: 

1. Login and logoff an HP 9000 series 300 computer. 
Degree of Confidence: EC C SC NS IJ 

2. Access the user interface software, "pmon", and use it effectively. 
Degree of Confidence: EC C SC NS U 

3. Gain on-line help and help contained in the 64000-UX system manuals. 
Degree of Confidence: EC C SC NS U 

4. Use a text editor such as Sk or Vi. 
Degree of Confidence: EC C SC NS U 

5. Create and use command files effectively. 
Degree of Confidence: EC C SC NS U 

6. Assemble and compile source code using the 64000-UX Language System. 
Degree of Confidence: EC C SC NS U 

7. Link the output of the Assemblers and Compilers to form absolute code. 
Degree of Confidence: EC C SC NS U 

8 . Build and modify measurement systems. 

Degree of Confidence: EC C SC NS U 

9 . Understand the philosophy of emulation. 

Degree of Confidence: EC C SC NS U 

10. Access emulation and have the ability to use the basic commands. 
Degree of Confidence: EC C SC NS U 

1 1. Understand the functionality of the internal analyzer and its use with 
the emulator. 

Degree of Confidence: EC C SC NS U 
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Course Review - HP 64000-UX Overview Course - 641 20T 

After finishing the training course, take a few minutes to indicate how 
you the student feel about performing each of the tasks listed below. 
Use the table below as a guide to determine what you feel your confidence 
level is for each of the areas specified. Circle your choice and return 
the completed form to the course instructor. 

EC - Extremely Confident 

C - Confident 

SC - Somewhat Confident 

NS - Not Sure 

U - Unable 

Your are now able to: 

1. Login and logoff an HP 9000 series 300 computer. 
Degree of Confidence: EC C SC NS U 

2. Access the user interface software, "pmon", and use it effectively. 
Degree of Confidence: EC C SC NS U 

3. Cain on-line help and help contained in the 64000-UX system manuals. 
Degree of Confidence: EC C SC NS U 

4. Use a text editor such as Sk or VL 
Degree of Confidence: EC C SC NS U 

5. Create and use command files effectively. 
Degree of Confidence: EC C SC NS U 

6. Assemble and compile source code using the 64000-UX Language System. 
Degree of Confidence: EC C SC NS U 

7. Link the output of the Assemblers and Compilers to form absolute code. 
Degree of Confidence: EC C SC NS U 

8 . Build and modify measurement systems. 

Degree of Confidence: EC C SC NS U 

9 . Understand the philosophy of emulation. 

Degree of Confidence: EC C SC NS U 

10. Access emulation and have the ability to use the basic commands. 
Degree of Confidence: EC C SC NS U 

1 1. Understand the functionality of the internal analyzer and its use with 
the emulator. 

Degree of Confidence: EC C SC NS U 
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□ Course Introduction 
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Course Introduction, page 1 



HP 64000-UX Training 
□ Course Introduction 



COURSE INTRODUCTION 

Who should attend? 

* New users of HP 64000-UX development system 

Philosophy of the course 

* Use existing HP 64000-UX documentation (manuals) 

• Teach basics of most important features of 

HP 64000-UX 

• Design labs for maximum hands-on experience 
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STUDENT NOTES: 
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HP 64000-UX Training 



□ Course Introduction 



COURSE INTRODUCTION 

Course Objectives 

• Use of a development system 

• Familiarity with HP 9000 Series 300 hardware 

• How to use the user interface software (pmon) 

• How to use sk (softkey editor) 

• Uses of command files 

• Assembling/Compiling/Linking source code 
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STUDENT NOTES: 
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HP 64000-UX Training 
□ Course Introduction 



COURSE INTRODUCTION 

Course Objectives 

• Familiarity with HP 64000-UX hardware 
» How to configure measurement systems 

• Understand principles of emulation 

• How to use a HP 64000-UX emulator to debug code 

• How to effectively use the internal analyzer with 

emulation 
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HP 64000-UX Training 



□ Course Introduction 



COURSE INTRODUCTION 

Knowledge Survey 

• Determine knowledge level of student 

- before course 

- after course 

• Use as feedback mechanism for course improvement 

• The student MUST be objective! 
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STUDENT NOTES: 
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HP 64000-UX Training 



□ System Introduction 



SYSTEM 
INTRODUCTION 
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System Introduction, page I 



HP 64000-U X Training 
D System Introduction 



Software Development Process 
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NOTES: 

The diagram above gives a general synopsis of the software development process of a project. The HP 
64000-UX product line and HP-UX help the designer with the following parts of the design: 

Specify /Design 
Implement/Construct 
lest/Debug 
Manage 

Hewlett-Packard currently sells a product called "Alis" which is used for project documentation and would 
aide with the following part of the design: 

Document 

STUDENT NOTES: 
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HP 64000-UX Training 
□ System Introduction 




NOTES: 



The "Specify/Design" phase of a project can be handled with the Teamwork SA/SD/RT products. 

SA: Structured Analysis SD: Structured Design RT : Real- lime Extensions 

The "Implement/Construct" phase can be handled with the Sk or Vi source code editors, the 6400(MiN 
Language System, or the available ADA language tools. 

The "Debug/lest" phase is were HP 64000-UX fits in. Logic Systems Division offers a wide variety of 
emulators and analyzers for almost every development need. 

The "Manage" portion of a project can be handled with the utilities shipped with HP-UX, such as "S< < N" 
(source code control system) and "make" (intelligent software management tool). 
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□ Interface Software 



USER 
INTERFACE 
SOFTWARE 
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Interface Software, page 1 



HP 64000-UX Training 



□ Interface Software 



USER INTERFACE SOFTWARE 

Purpose 

• Designed to give a user friendly, softkey-driven 

interface to HP 64000-UX 

• Interface software acts as an "operating system", 

"interpreter" or "shell" for the HP 64000-UX products 

• User Interface software is more commonly known 
as pmon 
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NOTES: 

Pmon is considered an "operating system" because it is the interpreter for some of the 64000-UX commands. 

STUDENT NOTES: 
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HP 64000-UX Training 
□ Interface Software 



PMON 

Features 

• User friendly 

• Learning interface to HP-UX 

• Similar interface to HP 64000 Logic Development 

System 

• Shipped with HP 64000-UX software 

• Command completion 

• Command recall 

• Softkey driven 

ISUIS O 1987 Hewlett-Packard Company 

MANUAL: page 1-2 User Interface Software Operating Manual 
NOTES: 

Command Compl eti on- is accomplish by typing the first few letters of a command, pressing the tab kry. 
and having pmon complete the command. This is an excellent time saving feature for the experienced ns< « 

STUDENT NOTES: 
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HP 64000-UX Tr aining 
□ Interface Software 



PMON 

Getting Started 

• Entering pmon 

• Special features 

- control characters 

- hidden commands 

• Softkeys 

• HP-UX command mapping 

• Exiting pmon 



IS1120 
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MANUAL: page 1-4 thru 1-8 User Interface Software Operating Manual 
NOTES: 

Many control characters are available as time saving features of the command entry editor. A brief list of 
the most common commands is on page I -4. A more complete list is in Appendix B of the manual. 

Some of these special commands are "hidden"; they have no soft key representation. The more useful 
commands are listed on page 1-8. A complete list of these commands is on page B-2 of Appendix B. 

Softkeys: a physical representation of an HP-X command associated with one of the eight function keys 
(f 1 -f 8) of the terminal keyboard. In essence, they map directly to HP-UX commands «n«l 
options. A complete listing of the command mapping is contained in Appendix A. 
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HP 64000-UX Training 



□ Interface Software 



PMON 



r 



STATUS: (message appear here) 



edit 



Command line 

dBptays 3 ines of 80 characters each 



I R i 



compile assemble link MEAS_SYSprom _prg HELP — ETC- 



Command 
Insert character 

Command string 
valid 

i=insert char 

^INSERT 
R=REVISE 



Softkey Label 
I — Line 



61 UO 



O 1986 



Hewlett-Packard Company 



NOTES: 

Command 1 ine: allows for commands up to three lines (240 characters) long 
Status 1 ine: gives error messages as well as command information and explanations 
User area: display are for output of commands 
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HP 64000-UX Training 
□ Interface Software 



PMON 

Softkeys 

• Visual representation of the eight function keys on 

keyboard (f1 - f8) 

• Multiple sets 

• Syntax directed commands - multiple levels of softkeys 
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NOTES: 

Eight function keys (f 1 -f 8) are available on HP terminals such as the HP2392. 

Multiple sets: many different sets of softkeys can be accessed with the ETC— 11 softkey. 

Dl rected syntax: softkey labels change to aid the user in entering commands with the proper syntaN 
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HP 64 000-UX Training 
□ Interface Software 



PMON 














Softkeys 














1 edit compile 


assemble 


link 


MEAS SYS 


prom_prg 


HELP 


— ETC— 




v J 




1 list dir remove 


move 


copy 


cat 


makedir 


removdir 


— ETC— 




V J 




[ chng_dir date&time 


opt_jest 


manual 


log 


shell 


-BACKUP- 


-ETC- 
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NOTES: 

The three sets of softkeys for pmon are shown in the diagram above* 

STUDENT NOTES: 



Interface Software, page 7 
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PMON SOFTKEY LABELING 


Key Label 


Description 


Key Function 






kpvworrl annpndpr) 






to command line 


HELP 


UPPERCASE 


performs function 






immediately, no carriage 






return is required 


<FILE> 


<UPPERCASE> 


pmon needs information 






entry from keyboard 


—ETC— 


—UPPERCASE — 


reacts immediately to 






leading dash. In 






softkeys are relabeled 






immediately 
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NOTES: 

The table in the diagram above shows the possible types of commands which are available in pmon. Tako 
note of these, especially the last one which requires user input. 

Softkeys with the syntax: '^LABEL^' are not executable, but will give information and/or syntax for tlio 
information needed. 

STUDENT NOTES: 



Interface Software, page 8 
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□ Interface Software 



PMON 

Special So ft keys 

• HELP softkeys 

• MEAS_SYS 

• BACKUP 



1135 
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MANUAL: pages 1-6 thru 1-7 User Interface Software Operating Manual 

NOTES: 

HELP softkeys: appear at many levels and give brief descriptions of commands available at that <ini< 
(page 1-6) 

MEASSYS softkeys: are the interface to HP 64000-UX emulation hardware, analysis hardware and 
software (page 1-6). These features will be explained later (day 3). 

BACKUP softkeys: allow the user to backup to tape drive or flexible disc. 



STUDENT NOTES: 
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PMON 

Directed Syntax 

* Softkeys ( f 1 - f8) dynamically relabeled 

* Labels on display indicate function 

• Keys relabeled as command entered or as cursor 

moves through command 

• All valid keywords displayed 
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NOTES: 

directed syntax: this allows commands to be entered quickly and effectively with little or no worrier 
making syntax errors. 

The softkeys are relabeled every time another softkey is pushed, thus giving the user the choice of all 
available options to a command. 



STUDENT NOTES: 
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PMON 

Directed Syntax Example 



H 

edit compile 


* 

assemble 


link 


ME AS SYS 


prom__prg 


HELP 


— ETC— 


v J 


asm m 














HELP <FILE> 


list 


nolist 


expand 


nocode 


xref 


-ETC- 


v J 


asm -xm 














HELP <SPACE> 


list 


nolist 


expand 


nocode 


output 


verbose | 


V J 


asm -xoh 














HELP <SPACE> 


list 


nolist 


expand 


nocode 


verbose 




V 9 / 
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NOTES: 

The next two slides show an example command being entered in pmon and how the softkeys change wMI« 
the command is being built. 

STUDENT NOTES: 
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PMON 

Directed Syntax Example 



asm -xo in 

HELP <FILE> 



list no list expand nocode verbose 



asm -xo main.S m 



i ♦ 

I Hst_tO 



print 



asm -xo main.S > 

<FILE> 



asm -xo main.S > main.Ol 
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STUDENT NOTES: 
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PMON 

Entering HP-UX Commands 

• Preceed all HP-UX commands with an "I" 

• !sh is very useful 

• Softkeys are more user friendly 
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MANUAL: page 1-7 User Interface Software Operating Manual 

NOTES: 

The T syntax is needed only while in pmon. It is not the syntax for normal HP-UX commands. 
Softkeys are set-up so the user has a more friendly, learning interface to HP-UX commands. 



STUDENT NOTES: 
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PMON 

How Commands are Interpreted 



User Interface 
Softwre reads 
the command 



Does 
i precede 
v command , 



it a pmon 
command , 



it a shell 
script 



HP-UX 
command 
is executed 



pmon 
command 
is executed 



HP-UX 
shell script 
is executed 




Command 

file is 
executed 



HP-UX 
command 
is executed 
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MANUAL: page 1-3 User Interface Software Operating Manual 

STUDENT NOTES: 



Interface Software, page 14 
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PMON 

Last Look at the Manual 

• Using the User Interface Softkey 

• User Interface Software Commands 

• Using and Creating Command Files 

• User Interface Software/HP-UX Cross Reference 

• Control Characters & Other Commands 



IS1150 
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NOTES: 

Chapter 1 - general information 
Chapter 2 - command syntax options 

Chapter 3 - commands files will be discussed later today in their own section 

Appendix A - HP-UX command cross referencing 

Appendix B - more good information about special pmon commands 



STUDENT NOTES: 
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HELP!! . page I 



HP 6 400 0-UX T raining 
□ HELP!! 



HELP!! 

Available Help 

• HP-UX 

• HP 64000-UX 
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HELP!! , page 2 
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HELP!! 

HP-UX 

• Hardbound set of manuals supplied with the HP 9000 

Series 300 computer 

• man <HP-UX command> 
man -f <keyword> 

on-line manual pages 
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NOTES: 

The HP-UX system manuals which contain the HP-UX command references are listed below: 

HP-UX Reference 

Sections 1 M, 2, 3, 4, 5, and 7 
Sections 1 and 9 

Both manuals are listed as a single part number (HP P/N 09000-90009). 



STUDENT NOTES: 



HELP!! , page 3 
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HELP!! 

HP 64000-UX 

• Hardbound set of manuals 

• HP 64000-UX Manual Map 

• man <64000-UX command> 
man -f <64000-UX keyword> 

On-line manual pages 

• "HELP" and "help" commands are available within 

- pmon 

- measurement system software 

- Sk editor 

• This training course 
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NOTES: 

The manuals which contain the detailed information about the HP 64000-UX commands are listed below: 

User's Guide for the HP 64000-UX Microprocessor Development Environment 

HP P/N 64801-90903 
User Interface Software for HP 64000-UX 

HP P/N 64808-90901 
Softkey Driven Editor 

HP P/N 64790-90901 
68000/68008 Emulation with Internal Analysis for HP 64000-UX 

HP P/N 64243-90903 
Measurement System for HP 64000-UX Microprocessor Development Environment 

HP P/N 64801-90908 
Emulation/ Analysis Reference Manual for 8 and 16 Bit Emulators 

HP P/N 64200-90912 
68000/08/1 0 Cross Assembler/Linker 

HP P/N 64845-90905 
68000/08/10 C Cross Compiler 

HP P/N 64819-90903 
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SYSTEM 
INTRODUCTION 
LAB 
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□ System Introduction Lab 



SYSTEM INTRODUCTION LAB 

Objectives 

• Familiarity with HP 9000 Series 300 hardware 

• Logging on and logging off 

• User file system 

• Introducing pmon 

- entering 

- using 

- exiting 

• Available HELP facilities 
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STUDENT NOTES: 
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HP 64000-UX System Introduction Lab 



Objectives: 

* familiarity with the 9000 series 300 hardware 

* logging on and logging off 

* the user file system 

* pmon (user interface software) 

* available help facilities 

Each of the sections of the lab are supplied with a box. This box 
should be checked by the student when the tasks or suggestions of 
each of these sections are completed. 



HP 9000 Series 300 Computer 

[ ] Survey the computer hardware of the 9000 series 300 computer. 
Locate the: 

computer monitor 
computer keyboard 
mouse 

computer CPU box 
system disc(s) 

LAN cable (local area network) 
RS-232 9-pin modem port 
HP-IB interface cables for: 

disc 

printer 

64000-UX instrumentation cardcage 

Notes: 

The LAN cable is a small coaxial cable connected to the computer 
through a "T" type connection. 

The HP-IB interfaces are for peripheral connections to the 
computer. 

A high speed HP-IB interface is used to connect the system disc. 
A slow speed HP-IB interface is used to connect a system line 
printer. 

A third HP-IB interface is used as a dedicated connection to 
the 64000-UX cardcage (64120). 



Logging On 

[ ] Log on the 9000 using the login name and password supplied by the 
instructor. 
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User Interface Software 

[ ] Type the command "pmon" to start the user interface software* 

You will notice two portions of the screen, the softkeys and the 
status line. The status line begins by showing the revision of 
software you have on the system. 

Push the 11 ETC — 11 softkey. You will notice that the softkey 

labels have changed and the status line now shows your current 

working directory. Push the 11 ETC — 11 softkey two more times 

and you see the same keys once again. 



[ ] Exit pmon by using one of the methods mentioned below. 
There are two ways to exit pmon: 

1. type the command "end" on the command line 

NOTE: although a softkey does not exist for "end" 
it can be typed in on the command line. 

2. use the end-of-file control sequence "cntrl d". 



Help Facilities 

[ ] Enter pmon again. 

Help is readily available inside pmon for both the 64000-UX 
commands and HP-UX commands. 

[ ] Press the "HELP" softkey and determine the method for gaining 
on-line help with HP-UX. 

[ ] Pmon is so friendly, it even offers help with syntax. Let's check 
the system date with the help of pmon. When the "date&time" 
softkey is pushed, only one new softkey appears ; "<DATE>". 
Anytime a softkey appears with greater than and less than signs 
(< >) surrounding it, the user is expected to provide input to 
the command whether it be a filename or the date and time. 

[ ] Press the "<DATE>" key and look at the information on the status 
line. Pmon is smart enough to prompt you for the proper syntax of 
user input! Now press the return key to see the current date and 
time. 

[ ] One last help facility is the "help" command. Type the command 
"help" on the command line and see what happens ! You now have 
even another way of getting help with HP-UX and 64000-UX. 

Complete this help command for both the options and see what 
additional information is available. 
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HP-UX Command Mapping 

[ ] Cycle the softkeys until the "listdir" set appears. Press the 
softkey and note that the softkey has become an "Is" on the 
pmon command line. In essence, the softkey has become an 
equivalent HP-UX command. 

[ ] Next, obtain an options summary of the "listdir" command using 
the available softkeys. 

[ ] Display the files of the current directory. Sort their names by 
modification times, the oldest file first. 

As options of original command are used, the softkeys continue to 
change to give the user the only options to the command. This is 
called directed syntax. 

[ ] Spend five to ten minutes experimenting with the various levels of 
softkeys for the HP-UX commands. 

NOTE: The following softkeys are used as part of the HP 64000-UX 
development system and will be discussed later: 
opt_test 
MEASJSYS 
prom prg 
compile 
assemble 
link 

NOTE: The following softkeys have more complicated functions and 
will be discussed later in the course: 
edit 
log 
shell 
-BACKUP- 
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Pmon Special Features 

[ ] The user interface software has a very helpful feature which could 
prove to be very timesaving to an experienced user; the idea of 
command completion. What this allows the user to do is type the 
first few characters of a pmon command and touch the "tab" key- 
Pmon will automatically complete the full command name for you! 

As an example type these letters on the command line: "lo" 
and press the tab key. You will notice that the command for 
"log commands 1 1 has appeared. Now compare this to pressing the 
softkey which represents this command. This could save some time 
if you did not have to cycle through the softkeys looking for a 
specific command. 

[ ] Pmon has another neat feature called command recall. You can use 
the control sequences "cntrl r" and "cntrl b" to cycle backward and 
forward through the previous commands. As an exercise, cycle back 
through the commands and re-execute the command for displaying the 
files of the current directory sorted on access time with the oldest 
file appearing first. 



Entering HP-UX Commands 

[ ] Since pmon is merely a program running on a shell, it is possible 
to start another process and temporarily leave the software. 
Use the help facilities to determine how to start this temporary 
process and then check and see what your current working directory 
is. HINT: "pwd" command. 

NOTE: when changing directories within pmon, never issued the "cd" 
command preceded by a "!". This will create a new shell 
change the directory for the new shell and will return to 
the parent shell. In essence, the directory is changed, but 
not in the shell the user desired. 
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[ ] Next, use this new feature to TEMPORARILY exit pmon by creating a 
shell. Hint: look at the pmon "shell" command. 

Try an HP-UX "Is" command. Notice this was done under the HP-UX 
operating system and not under pmon. 

Once you have successfully started another shell out of pmon, kill 
that shell with a "cntrl d" or an "exit". Where did you end up? 
As you can see this is a very helpful feature of pmon and can 
save large amounts of time not having to exit pmon, do something 
and then start the program over. 

NOTE: if you start a shell out of pmon, DO NOT type in "pmon" 
to get back! This will cause an enormous number of processes 
to be created. 



Additional HP-UX commands 

[ ] If time permits, experiment with the other available HP-UX commands 
available within pmon listed below: 

remove 
move 
copy 
cat 

makedir 
removdir 
chng dir 
date&tme 
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EDITORS 

What is Available? 

• The HP-UX visual editor: Vi 

• The HP 64000-UX softkey driven editor: Sk 



OVI6.10 
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STUDENT NOTES: 
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EDITORS - Vi 

Features 

• Full-screen visual editor 

• Fast access 

• Shipped with HP-UX software 

• User-definable macros 

• Configurable editing attributes 

• Undo commands 
Disadvantages/Limitations 

• Commands are sequences of keystrokes which must be 

memorized 

• Difficult text block manipulations (cut and paste) 

• Difficult range editing 

OV16.15 O 1987 Hewlett-Packard Company 

NOTES: 

The biggest drawbacks associated with the Vi editor are the cryptic commands which must be memorized Jo 
become proficient with the editor. 1 here is a considerable amount of time required to learn Vi. 

One of the nicest features of the Vi editor is the "undo" command. This allows the user to undo the las< 
insertion of text or deletion of text. 

More information is available on Vi in the following manual: 

Text Editors and Processors 
HP-UX Concepts and Tutorials 
HP P/N 97089-90022 

STUDENT NOTES: 
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EDITORS 

What is Available? 

• The HP-UX visual editor: Vi 

* The HP 64000-UX softkey driven editor: Sk 
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STUDENT NOTES: 
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EDITORS 



Sk 



Purpose 

• Full screen softkey driven HP 64000-UX source code 
editor 

How do I get the software? 

Sk is available as a HP 64000-UX option 
HP P/N 64790S #004 
(HP 9000 Series 300 hosted) 
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MANUAL: page 3-1 Softkey Driven Editor 

NOTES: 

The Sk editor is available as an option to the 64000-UX Development Environment Contact your !<>< ;H 
Hewlett-Packard sales representative (FE) for more information. 



STUDENT NOTES: 
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EDITORS - Sk 

Features 

• Full screen 

• Softkey driven - syntax directed commands 

• Command files available 

• Complete compatibility with HP-UX and HP-UX editors 

• Command recall 

• Command completion 

• Block text manipulation commands 

• Easy cursor movement within files 
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MANUAL: page 3-1 Softkey Driven Editor 
NOTES: 

Sk has all of the features of a conventional editor plus the different features listed below: 

command recall 
command completion 

softkey driven - syntax directed commands 
block text manipulation commands 
line number referencing 
command files available 

STUDENT NOTES: 
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EDITORS - Sk 

Editor Modes 

• Command Mode 

• Insert Mode 

• Revise Mode 
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MANUAL: pages 3-3 thru 3-5 Softkey Driven Editor 

NOTES: 

The default editor mode is "insert mode" for a new file and the "command mode" for already existing file. 



STUDENT NOTES: 
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EDITORS - Sk 

What will the screen look like? 



Text Area (Displays 72 columns on standard Terminal) 





START 




1 

2 




3 




> 4 




5 


Text Area <C 


6 


Displays 19\ 


7 


lines on I 


8 


standard 


9 


terminal V 


10 




END 



▼ 



STATUS: {message appear here) 

> Command Line 
— f displays 3 lines of 80 characters each 

INSERT REVISE delete find 



Column 



replace <line t > 



I 

R 
t 

i r 



end 



--ETC- 



Cursor Location 
(not present in 
command mode) 

Command 
Insert character 

Command String 
Valid 

i=insert char 

^INSERT 
R=REVISE 
t=TABSET 
r= RANGE 



Softkey Label 
i — Line 
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MANUAL: pages 4-1 thru 4-6 Softkey Driven Editor 



NOTES: 

The Sk editor display screen is made up of the following parts: 

text area 

line numbers 

status line 

command lines (3) 

softkey command labels 

column number and editor status indicators 

The editor cursor is used to show the position of the current edit command; whether it is on the conmi;»n<* 
line or among the text in the text area. 

All the information given in this section will be based on a standard Hewlett-Packard terminal such ;ts Mi- 
HP 2392A. 
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EDITORS 

Softkeys 



- Sk 



INSERT REVISE delete find replace <LINE+-> end —ETC- 



merge copy extract retrieve join split list —ETC— 



renumber repeat tabset range autotab save edit — ETC — 



while insert colm_num log help 



WHATCHAR --ETC- 



ovi e.45 
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MANUAL: page 3-2 Softkey Driven Editor 

NOTES: 

The above diagram shows the "first" level of softkeys available for the Sk editor. In essence, there is imk 
first level of softkeys which contains four sets. 



STUDENT NOTES: 
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Sk EDITORS SOFTKEY LABELING 


Key Label 


Description 


Key Function 


find 


lowercase 


kevword aDDended 
to command line 


INSERT 


UPPERCASE 


exits one mode and 
enters the mode 
specified 


<LINE +-> 


<UPPERCASE> 


Sk needs information 
entry from keyboard 


— ETC — 


—UPPERCASE — 


Sk reacts immediately 
to leading dash. In 
this case softkeys 
are relabeled immediately 
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NOTES: 

The table above defines the syntax of the various types of commands and softkeys of the Sk editor. 

STUDENT NOTES: 
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EDITORS - Sk 

Special Features 

• Softkeys - map to terminal keys f1 thru f8 

• Command recall 



CTRL 



CTRL 



- recall latest commands (newest to oldest) 

- recall latest commands (oldest to newest) 



• Entering non-printing characters 

- useful for entering formfeeds 



CTRL 



• Screen refresh 



CTRL 



I - (lowercase L) 
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MANUAL: pages 4-3 thru 4-4 Softkey Driven Editor 

NOTES: 

One of the most productive features of the Sk editor is the ability to recall commands from the comim»"<' 
buffer. 

The entering of non-printing characters becomes extremely useful when control sequences or <\m 
sequences have to be used in a file, i.e. "formfeeds" can be entered before sending a document to a prinU » 



STUDENT NOTES: 
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EDITORS 



Sk 



String Delimiters 

* double quotes ( ") 

* single quotes ( ' ) 

• carets ( A ) 

String Wildcards 

» anystring ( #) 

• anycharacter ( ?) 



O 1987 Hsxlell-Pscksrd Company 



NOTES: 

The string delimiters and string wildcards of the Sk editor shown above match the same characters nsr<J !» 
HP-UX for these functions. 



STUDENT NOTES: 
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EDITORS - Sk 

Directed Syntax 

• Softkeys ( f 1 — f 8 ) dynamically relabeled 

• Labels on display indicate function 

• Keys relabeled as command entered or as cursor 

moves through command 

• All valid keywords displayed 
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NOTES: 

directed syntax: this is a feature of Sk which is used in conjunction with the softkeys to makr 
command entry and command syntax as easy to use and remember as possible. As a command is entered, 
the softkeys change dynamically to show the user what syntax is appropriate. This aids in the building <>* 
complex commands and allows inexperienced users of the Sk editor to become more proficient with Sk in l<w 
time. 



STUDENT NOTES: 
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EDITORS - Sk 

Directed Syntax Example 



INSERT REVISE 



delete 



find 



replace <LINE+-> end 



-ETC- 





replace PI 










1 <STRING> with 


thru 


until 


all ; 




V J 


replace "hello" ■ 
with 


thru 


until 


all ; 












J 


replace "hello" with M 










<STRING> 










V J 


replace "hello" with "goodbye" M 




i 






thru 


until 


all ; 




V 








J 


replace "hello* with "goodbye" all H 

{ ■ J 
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NOTES: 

Let's take a look at an example of replacing one word with a different word throughout an entire file, 
could be useful when changing the name of a symbol or an opcode in an assembly source file. 



STUDENT NOTES: 
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MORE INFORMATION 

Vi 

* On-line manual pages 

* HP-UX Concepts and Tutorials 

Text Editors and Processors 
HP P/N 97089-90022 

* Introducing UNIX System V 

HP P/N 98597-90620 

* Vi Reference Card 

HP P/N 98597-90000 
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NOTES: 

All of the resources above should be made available to you during the training course. The "on-line mamuil 
pages" and the Concepts and Tutorials manuals were also shipped with your MP 9000 series 300 comi>«M<» 



STUDENT NOTES: 
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MORE INFORMATION 

Sk 

• On-line manual pages 

* Softkey Driven Editor manual 

HP P/N 64790-90901 
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NOTES: 

As is the case most of the time, your best reference for HP 64000-UX products are the manuals supplied 
during this course and with your initial order. Knowing where to look in the manuals is one of the m<>»« 
important points of being successful with a complicated system such as 64000-UX. 



STUDENT NOTES: 
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EDITORS - Sk 

Last look at the Manual 

* Modes Structure, and HP-UX Connections - Chapter 3 

* Getting Started - Chapter 4 

* Editor Command Syntax - Chapter 5 

* H':lp and Problem Solving - Chapter 6 

* Editor Status Messages - Appendix A 
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NOTES: 

Let's take a last look at the sections of the Sk manual. 

STUDENT NOTES: 
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COMMAND FILES 

Purpose 

* Source files created by the user 

* Perform series of commands with minimum input from the 

user 

Features 

* Eliminate repetitive entry of commands 

* Efficiently edit files and make HP 64000-UX 

measurements 

* Parameter passing is available 

* Available for: - HP-UX 

- Measurement System Software 

- pmon 

- Sk 
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MANUAL: pages 7-1 thru 7-2 HP 64000-UX User's Guide 

NOTES: 

The command files for pmon, Sk, and the Measurement System software all have the same comm;nid 
formats. These command files can he used to call the other HP 64000-UX applications, i.e. n union 
command file can he used to call the Sk editor and perform a series of edits. 

STUDENT NOTES: 



Command Files, page 2 
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COMMAND FILES 

HP-UX Command Files 

• Shell scripts 

Using HP-UX Shell Scripts 

• Useable at an HP-UX prompt 

• Useable within HP 64000-UX applications if 

preceeded by an " ! " 

• Files have executable permissions set 



Wl 7.15 
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NOTES: 

Shell scripts are a very powerful tool of the HP-UX Operating System. They will be mentioned in <M' 
course, but only time and experience can help a user write efficient shell scripts. 

Being able to call HP-UX shell scripts from a 64000-UX application gives the user even greater fle\iMIH> 
using 64000-UX with HP-UX. 



STUDENT NOTES: 
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COMMAND FILES 

Creating HP-UX Shell Scripts 

• Can create with ASCII text editor 

- Sk 

- Vi 

Example; 

• The user's .profile file 

• Shell script run automatically upon logging on to 

the HP 9000 Series 300 computer 

• Your .profile is easily customized 



OV17.20 O 196? Mw*tl-P>ck»d Canon/ 

NOTES: 

.profi le fi 1 e: is a command file or shell script which customizes the user's HP-UX environment during 
login. 

STUDENT NOTES: 
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□ Command Files 



COMMAND FILES 

Passing Positional Parameters 

* Specifed with command name 

• Syntax: <HP-UX shell script> <$1> <$2> 

Example of file: is it there 



echo "Searching for $1 in $2" 


#echoes string with values of $1 




and $2 substituted 


grep $1 $2 


#searches for the string $1 in file 




$2 


echo "Done" 


#indicate when finished 



* Execute by typing: is_it_there <$1> <$2> 



OV17.25 
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NOTES: 

The positional parameters of an HP-UX shell script MUSI be included with the shell script command. 
Shell scripts cannot prompt the user for information unless they were written specifically to do that. 



STUDENT NOTES: 
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□ Command Files 



COMMAND FILES 

More Help on HP-UX Shell Scripts 

• Shells and Miscellaneous Tools 
HP-UX Concepts and Tutorials 
HP P/N 97089-90062 
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STUDENT NOTES: 
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COMMAND FILES 

Types of HP 64000-UX Command Files 

• Pmon 

• Emulation/Analysis session 

• Sk 

Using HP 64000-UX Command Files 

• Usable only with the specific application 

• Files are non-executable 



OVI7.35 
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MANUAL: pages 7-1 thru 7-2 HP 64000-UX User's Guide 

NOTES: 

HP 64000-UX command files DO NOT have their execute permissions set and will only run properly v*hm 
issued within the specific 64000-UX application. 



STUDENT NOTES: 



Command Files, page 7 



□ Command Files 



COMMAND FILES 

Creating HP 64000-UX Command Files 

• log_commands to <file> command 

• Can create with ASCII text editor 

- Sk 

- Vi 

Example: 

• Figure 7-1 page 7-2 

HP 64000-UX User's Guide 
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MANUAL: pages 7-2 thru 7-4 HP 64000-UX User's Guide 



NOTES: 

A example of a very productive 64000-UX command file is shown on page 7-2 of the User's Guide. 

NOTE: the softkey label and the actual 64000-UX command usually do not have the same name. A?> am 
example, the softkey "log" translates into the 64000-UX command "log commands". The full 64000-UX 
command must be used in the command file. 

When using the "log commands" command, every command issued by the user will be written into <h< 
command file, even commands which result in errors. The user is responsible for editing the commands 
which caused errors out of the command file. 



STUDENT NOTES: 
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COMMAND FILES 

Passing Parameters 

• Added flexibility 

• Make command files generic 

Example of Sk command file named: 



substitute 



PAR MS &OLDWORD &NEWWORD 

# declares formal parameters to be passed 

while find "&OLDWORD" all do replace "&OLDWORD" with 
"NEWWORD" all doend 

# finds each occurance of &OLDWORD and 

# replaces it with &NEWWORD 



Execute by typing: substitute only within Sk 
All unknown parameters will be prompted for: 

Define parameter &OLDWORD 
Define parameter & NEWWORD 
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MANUAL: pages 7-5 thru 7-6 HP 64000-UX User's Guide 

NOTES: 

The above example will give you a good idea of the uses and power of command files. 

parameters : these are variables which can be changed or customized each time a command file is run. 

HP 64000-UX command files will prompt the user for unknown values of parameters in the command ttl<\ 
unlike HP-UX shell scripts. 

NOTE: the "PA RMS" statement must be on the first line of the command file. It must also contain AM 
the parameters associated with the command file on that one line or the command file will interpret Mir 
commands improperly. 



STUDENT NOTES: 
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□ Command Files 



COMMAND FILES 

Comparison 



HP 64000-1 JX 


HP-I IX 


- non executable file 


- executable file 


- run within HP 64000-UX 


- run from HP-UX prompt 


application 




- created within application 


- created by editor 


or by editor 




- can call HP-UX shell script 


- can call HP 64000-UX 




command files (example: page 




7-10 of User's Guide) 


- parameters can be "passed" 


- parameters must be "positional" 


or "positional" 


unless code is written for 




prompting 
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MANUAL: page 7-9 HP 64000-UX User's Guide 

NOTES: 

The chart above lists the major differences between HP 64000-UX command files and HP-UX shell s< i»i><s 
Two of the most important points to remember about shell scripts and command files are: 

- command files can call HP-UX shell scripts and HP-UX shell scripts 
can call command files. A example of this is shown on page 7-1 0 

of the User's Guide. You should take a few minutes to look at this 
example. 

- command files will prompt the user for unknown parameters where HP-UX 
shell scripts will return an error if all the parameters are not 

specified. 
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STUDENT NOTES: 
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COMMAND FILES 

Graphical Example 



assemble 



compile 




HP 64000-UX 
command files 



pmon 
'Operating System" 



shell 
scripts 



HP-UX Operating System 
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NOTES: 

Pmon functions as a type of Operating System for the 64000-UX products. It resides on top of the HP-* iX 
Operating System and gives the user a friendly and learning interface to HP-UX and 64000-UX. 

This diagram represents the abilities of 64000-UX command files to call HP-UX shell scripts Jind 
vice/ versa. 

You will notice that the diagram also makes and important point about 64000-UX commands. For the mos< 
part, 64000-UX commands also exist as HP-UX commands, but are only mapped as softkeys to make ihr 
software designer's job much more efficient. 



STUDENT NOTES: 
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EDITOR/ 
COMMAND FILES 
LAB 
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□ Editor/Command Files Lab 



EDITOR/COMMAND FILES LAB 



Objectives 

• The advantages/disadvantages of Vi and Sk 

• Creating and editing files with Sk 

• The advanced editor commands of SK 

• Creating command files (HP 64000-UX) 

- with Sk 

- with the log_commands command 

• Creating HP-UX command files (shell scripts) 

• Executing command files 
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STUDENT NOTES: 
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HP 64000-UX Editor/Command Files Lab 



Objectives: 

* advantages/disadvantages of Vi and Sk 

* creating and editing files with Sk 

* advanced editor commands of Sk 

* creating command files 

* with Sk 

* with the "log commands" command 

* creating HP-UX command files (shell scripts) 

* executing command files 

Each of the sections of the lab are supplied with a box. This box 
should be checked by the student when the tasks or suggestions of 
each of these sections are completed. 



Accessing the Editors (Vi and Sk) 

[ ] Both of these editors have the same syntax for starting an edit 
session; either creating a new file or editing a existing file. 
Starting the editors is as easy as: 

vi starts the vi editor 

vi <filename> starts the vi editor to edit <filename 

sk starts the sk editor 

sk <filename> starts the sk editor to edit <filename> 

The "edit" softkey in pmon is defined to be one of these two editors- 
Enter the pmon software and touch the edit softkey, but do not hit 
the return key. Which editor is defined for your environment? 

[ ] The edit softkey is defined by the shell variable "EDITOR". This 
default can be changed in the user's ".profile" file. Use the 
Sk editor to modify the EDITOR variable. Hint: the Sk editor is 
located in "/usr/hp64000/bin" and the name of the command is "sk". 
End out of the edit session using the "end" softkey and execute the 
following command: 
. .profile 

Once again enter pmon and begin to start an edit session. The 
"edit" softkey should now be mapped to the Sk editor. 

You have already edited a file with Sk. Did you have trouble? 
Or was the softkey driven editor easy to use? 
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The Vi editor does have its advantages. First it is shipped with 
HP-UX where the Sk editor is available as an option. Second, the 
access time and response time of Vi is slightly better than that 
of Sk. But, the major difference is that Sk is simple to use, 
even the first time as compared to a cryptic editor like Vi. It 
is highly recommended that you use the Vi Reference Card to help 
you get started. 



Exiting the Editors 

[ ] Once you have gained access to an editor, it is wise to learn how 
to save a file and end the edit session. 



[ ] Enter the Vi editor. Use the Vi Reference Card to determine how to 
enter the following sentence: 

The slow brown fox ran into the lazy dog! 
Then save this new file with the following command: 

<esc> <esc> :wq lazy. dog 
The two <esc> f s get the editor into its command mode and the 
":wq lazy. dog" tells the editor to write the changes, quit the 
editor and save the contents in a file called lazy. dog. 

[ ] You have already had experience ending out of the Sk editor, but 

since you noticed the expression in "lazy. dog" is wrong, correct it 
using the Sk editor to: 

The quick brown fox jumped over the lazy dog! 



The Sk Editor 

[ ] Since the Vi editor was covered in the first day of this course, 
equal time must be given to Sk. Have you noticed that many of 
the same features of pmon are also inherent in the Sk editor. Many 
of these include the use of softkeys, the same basic display screen, 
closely related STATUS lines, command completion and command recall- 

[ ] As an exercise, print a copy of your .profile file with the 
following command: 
lp .profile 

Then use the printout as a template to create a new file called 
"myprofile" which has the exact contents as your .profile. 
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[ ] Take 20 to 30 minutes to learn as many features of the Sk editor 
as possible. Remember, the same help facilities exist in the 
Sk editor as did in pmon: 

"help 11 command 

syntax directed softkeys 

Another good file to play with can be created with the following 
command : 

banner I love Sk > editor. play 

Learn the uses of the following commands: 

REVISE delete end save 

INSERT <LINE+-> extract retrieve 

replace find copy renumber 

help save 

One of the most powerful features of the Sk editor is the ability 
to do different types of range editing. 

If time permits and you like challenges: 

repeat range while insert 

list join split WHATCHAR 

edit merge log 

IMPORTANT!!! The absolute best time to ask questions about a new 
product is during a lab like this. 



Creating Command Files 

[ ] Make sure yon the Sk editor and return to the pmon software. 

[ ] The exercise which follows will give you more practice with the Sk 
editor and also introduce you to command files. It will also show 
you that command files are available for both Sk and pmon. Exit any 
edit session you may be working on and enter pmon. Begin logging 
commands to a command file by using the "log" softkey. Name the 
command file '"edit. monitor". Read the help messages if necessary or 
ask for help. 
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[ ] From pmon issue the command to copy the file "$HOME/emul/mon 68000 .s p " 
to a file named "$HOME/new_monitor". The following editing of the 
"new monitor" file should be completed. 

[ ] Using the Sk editor softkeys, replace every occurrence of the string 
"MONITOR JSOOTROL" with the string "MONITOR COTRL". 

[ ] Uncomment the "TRAP #5" software breakpoint vector and its appropriate 
ORG statement. 

[ ] Now this is a challenge. In the file, there are many lines which 
consist of nothing but "*"» s. Replace each "*" with a "#" 
in the 25th through the 50th columns of these lines. In essence, 
replace: 

with: 

****************^ 

HINT: use the range and replace commands to make this easy! 

[ ] When that task is complete, end out of the editor and save your 
changes. Then issue the command to pmon to close the log file. 

[ ] Edit the command log file (edit. monitor) to see what it looks like. 
You should notice that it logged every command you made into the 
file whether it was an error or not. If you ever plan to use a 
command file that you create in this way, you MUST edit the 
unwanted commands out of the file or they will be executed just 
will the wanted commands . Edit the command file so that each task 
specified above can be completed automatically. To test your command 
file, make sure the command to copy the original file to your home 
directory and the command to enter the Sk editor are still in your 
command file and execute the command file by typing "edit. monitor" 
on the pmon command line. Verify its proper operation and fix any 
bugs which may arise. NOTE: be sure to include the command to exit 
the Sk editor when the command file is finished. Also you can use the 
"wait" command in the command file to help verify its proper 
operation by pausing the execution of the command file. 

[ ] Command files can also be created by entering the pmon or sk 

commands into a file with an editor. The only gotcha with this 

method is that you do not have the helping hand of syntax directed 

softkeys to help keep the errors to a minimum. 
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[ ] One important point to keep in mind concerning 64000-UX command 
files, is that they can only be run from within the program, i.e. 
within pmon or Sk. These files do not have the ability to be 
run as separate executable files, i.e. NEVER change the permissions 
on a 64000-UX command file to make it executable. 

[ ] A more efficient and productive use of command files will be 

introduced during the emulation section of this course. This lab 
is meant only to introduce the methods and concepts of creating 
command files. In reality, they can save large amounts of time 
by eliminating the need to enter repetitive commands over and over 
again. 

[ ] As an exercise in parameter passing for the 64000-UX command 
files, copy the example from page 10 of the Command Files 
section in the student workbook (comments optional) . Get the 
command file to work by practicing on different words in the 
"new monitor" file. 

[ ] As a final exercise, create a command file which will modify a 
specified file and add 5 blank columns to the leftmost portion 
of the file. This will be helpful in changing the margins of a 
file if it needs to be printed out. HINT: range command and 
replace command. 

[ ] Test this command file and make sure it works properly. 



HP-UX Command Files (shell scripts) 



[ ] Use the editor of your choice to create a file called "find.it". 
In that file enter the following: 

# usage: find.it <string> <filename> 

grep $1 $2 
Save the file. 

The "$1" and "$2" are considered positional parameters. These 
parameters become part of the command when it is executed, just 
like the filenames of the "cp" command are necessary. 

[ ] Execute the shell script to search for your username entry in the 
/etc/passwd file. 
Example: 

find.it root /etc/passwd 
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[ ] As you noticed, you were flagged with an error telling you that 
the "execute permission was denied". This is the big difference 
between HP-UX shell scripts and 64000-UX command files. The 
HP-UX shell scripts must have their execute permissions set to 
be of any use. 

Use the following command to set the permissions properly: 
chmod 777 find.it 

[ ] Re-run the shell script to search for your login name in the 
/etc/passwd file. Do not forget to include the positional 
parameters. 

Not only can shell scripts have parameters , but so can the 64000-UX 
command files. This feature opens up the flexibility of command 
files so that their functionality is only limited by an 
individuals resourcefulness. 

[ ] A perfect example of a shell script is your ".profile" file which 
resides in your HOME directory. Do a listing of the permissions 
of this file to verify that it is an acceptable shell script. 
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HP 64000-UX LANGUAGE SYSTEM 

Features 

• Large processor language support base 

• C, Pascal, and Assembly relocatables can be linked 

together 

• Core assembler and linker technology common to all 

assembler/linkers 

• "make" files available 



UX11.10 O 1987 Hs*MI-P»diar<l Company 

NOTES: 

C and Pascal compilers and assemblers are available for a large number of processors and processor families 

The HP 64000-UX Language System assemblers and compilers generate relocatables with the same til* 
format. These relocatables can therefore be linked together to form one absolute file. 

makefi 1 es : same function as command files but only perform the parts of assembling / compiling / linMnr. 
which are needed. The "make" command uses file time stamping to determine if a given relocatable r 
up-to-date. This utility is also used for source code control. 

STUDENT NOTES: 
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HP 64000-UX LANGUAGE SYSTEM 

Components 

• Assembly language support 

• Cross Assemblers 

• High-level language support 

- C Cross Compilers 

- Pascal Cross Compilers 

• Absolute file generation 

- Linkers 



UX1 1« 
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NOTES: 

The HP 64000-UX Language System consists of cross assemblers and cross compilers which generate* <h< 
relocatable files. It also consists of linkers which combine the relocatable files into an absolute file. 

The word "cross" refers to language system tools which create files to be used on other hosts. A compiled 
file to be used on the 9000 series 300 computer would have a "native" compiler. 



STUDENT NOTES: 
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HP 64000-UX LANGUAGE SYSTEM 

Source Code 

• Input files to assemblers or compilers 

• Created with ASCII editor 

• Created on different hosts 

- HP-UX 

- VMS 

- MS-DOS 

File naming conventions 

• Assembly source code file - filename.S 

• C source code file - filename.C 

• Pascal source code file - filename.P 

UX11.20 O mi Hewlett-Packard Company 

NOTES: 

The file naming conventions for source code files are strongly recommended, but not necessary. 

STUDENT NOTES: 
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HP 64000-UX LANGUAGE SYSTEM 

Absolute Code 

• Assembling source code into relocatables 

* Compiling source code into relocatables 

• Linking relocatables to create the absolute 

File naming conventions 

* Absolute code file - filename.X 
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NOTES: 

The file naming convention for the absolute code file is defined by the linker. 

STUDENT NOTES: 
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ASSEMBLERS 

Purpose 

• Convert processor specific assembly source code into 

binary relocatable files 

Features 

• Generates symbol information used by analyzers 

(edbuild) 

• Generates symbol cross-reference information 

• Detailed listing files are possible 
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MANUAL: page 1-2 68000 Cross Assembler/Linker 
NOTES: 

The assembler generates a -".A" file which is used by the edbuild command to create the symbol database filr 
f, .Y" which is in turn used by the 64000-UX analyzers and emulators. 

Options to the listing files are available and will be explained later in this section. 

STUDENT NOTES: 
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ASSEMBLERS 

Functional Components 

• Initialization 

- input file 

- listing file 

- options 

- processor directive 

• Generate symbol table 

• Generate relocatable code 

• Generate error messages 

• Generate sorted assembler symbol file 

• Generate cross-reference map 
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MANUAL: page 2-1 68000 Cross Assembler/Linker 



NOTES: 

Generating the cross-reference map is only performed if the ,! xref n option is specified for the listing file. 

You can find a good introduction to assembler technology in Appendix A of the 68000 Cross 
Assembler/Linker manual. 



STUDENT NOTES: 
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ASSEMBLERS 

Processor Directive 

• Contained in source file 

• First line of source file 

• Syntax 

- "processor" options 

- "processor" tells which assembler 

- options tells output files characteristics 



ASI120 
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MANUAL: pages 2-3 thru 2-5 68000 Cross Assembler/Linker 

NOTES: 

Hie processor directive for a source file MUSI be on the first line of the file, with no blank lines preceding 
it. 

The options which can be specified as part of the processor directive command can also be specified ;i< 
options to the HP-UX command. 



STUDENT NOTES: 
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ASSEMBLERS 

Output Files 

* filename.R - relocatable file 

• filename.A - assembly symbol file 



• listfile.O 



listing file (not created by default) 
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MANUAL: pages 2-2 thru 2-3 68000 Cross Assembler/Linker 



NOTES: 

f 1 lenstne. R: this file is the relocatable for the source code which was assembled. It has the same Iwv 
filename as the source file and contains the assembled object code. 

fi 1 ename . A: this file contains the symbol and line number information of the relocatable file. It is n.sed 
by the edbuild command, which will be discussed later. 

listfile.O: this file is optionally created by the user and contains the assembly code with ofsH 
addresses specified for the symbols and code. It can also contain a symbol cross reference table depending 
on the options specified. 

The H .R" and ".A" files are created by default by the assembler, whereas the ".()" file is not created I'm 
default. The ".O" -convention is the standard for any type of listing file. It is recommended tha< <M 
convention is used, but is not necessary. 

CAUTION: if the h .O m convention is used, be careful not to name the assembler or compiler listing file th«; 
same as the linker listing file, or the assembler or compiler listing file will be overwritten! 
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STUDENT NOTES: 
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ASSEMBLERS 

Options of the Listing File (.0) 

• List - listing of source program 

* Nolist - no listing, except errors 

♦ Expand - listing of all source and macro generated 

codes 

• Nocode - no object code generated 

* Xref - symbol cross-referencing 
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MANUAL: pages 2-6 thru 2-9 68000 Cross Assembler/Linker 
NOTES: 

Listing files are not necessary, but HIGHLY RECOMMENDED! 

The options to the assembler can be specified in the source code file as options to the processor dim <>><• 
(page 2-3) or as options to (lie HP-UX command (page 2-5) which are mapped as softkeys. 



STUDENT NOTES: 
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ASSEMBLERS 



Assembler Directives (pseudo instructions) 

• Optional instructions which control assembly 

• Examples 

- ORG - location counter control 

- END - module termination 
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MANUAL: pages 5-1 thru 5-3 68000 Cross Assembler/Linker 

NOTES: 

The two pseudo instructions listed are probably used more than any others. 

ORG: (page 5-20) this instruction is used to specify an absolute address for the code listed after it. H 
the location counter to the address specified in the operand field of the source code. 

END: (page 5-9) this instruction is used to show the logical end of a program module. It is optional »»d «' 
specified with a label will define a transfer address offset for that module. Transfer addresses will i>« 
covered on the next slide. 



STUDENT NOTES: 
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ASSEMBLERS 


Transfer Address 


• Start address of main routine 


• Assembler determines if module contains transfer 


address 






'68000' 






HARRY ORG 01000H 






source code 






END HARRY 
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NOTES: 

transfer address: this is defined in one of the relocatable files of a program to be the starting adch*s 
of the main program. 

The label "HARRY" tells the assembler that this module will contain the transfer address. Onl> <>n< 
transfer address is allowed for the relocatable files which will be linked together to form the absolute. 1 ■'«>»■ 
the example shown, the transfer address will be defined as 1000H. 

Specifying an "END" with no label or not including the "END" directive will not define the transfer addr^v 
It will default the transfer address to 0000H until it is defined by another relocatable file. 



STUDENT NOTES: 



Assemblers , page 9 



HP 64000-UX Training 
□ Compilers 



COMPILERS 
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NOTES: 



The C compiler language manual will be used for this section, but the compiler information presented hei 
applies to both the C compiler and the Pascal compiler, except where noted. 
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□ Compilers 



COMPILERS 

Purpose 

* Convert C or Pascal source code into binary relocatable 

files 

Features 

• Generates line numbers for source line referencing 

• Supports symbolic debug 

* Interfaces with Software Performance Analyzer for 

duration measurements 



C011.K) O T987 htewteCt-Pactord Company 

MANUAL: pages 2-1 thru 2-3 68000 C Cross Compiler 

NOTES: 

Line numbers are generated by the compiler and contained with local symbols in the M .A" file. 

symbolic debug: using symbols for physical address references. An example would be: "run 
<symbol>" 

The compiler also generates the information necessary for the software performance analyzer to pe» 
duration measurements on modules of code. 

STUDENT NOTES: 
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COMPILERS 

Language Descriptions 

Pascal L anguage 

• Contains many extensions to and a few subsets of the 

Pascal User Manual S Report 

second edition by Jensen and Wirth "standard" 

C Language 

* Full implementation of C programming language as 

defined in The C Programming Language 
by Kernighan and Ritchie 
- "Standard I/O Library" functions not included 

NOTE: Deviations and extensions of a compiler to the "standards" 
are listed on the first pages of each compiler manual 

C01U2 O 1967 He«mi-Pw*«r<> Company 

NOTES: 

The HP 64000-UX Pascal Cross Compilers implement an extension of the Pascal programming langumr 
which is specifically designed and optimized for microprocessor development Although closely aligned "Mh 
the Pascal language as defined in "Pascal User Manual and Report - Second Edition" hy Kathleen Jensr»» 
and Niklaus Wirth (Springer- Verlag, 1976). the HP 64000-UX System Pascal language contains m*nn 
extensions and a few subsets of the Jensen and Wirth "standard" 
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The HP 64000-UX C Cross Compilers provide a full implementation of the C programming language 
defined in "The C Programming Language" by Brian W. Kernighan and Dennis ML Ritchie (Prentice-M 
1978) and the supplement published November 15, 1978. Hewlett-Packard has also extended thv 
language to improve its utility as a tool for microprocessor system programming and to make optimum usv 
the HP-UX and HP 64000-UX software development tools. 

The "standard I/O library" functions (printf, getchar, etc) are not included. External references 
generated by the compiler for these functions. 

STUDENT NOTES: 
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COMPILERS 

Functional Description 

* Optional preprocessor - facilities to alter source code 

• Reads source code 

* Creates symbolic language (IDS) 

* Reads IDS 

• Generates cryptic assembly language invented 

by HP 

• Processor specific code generator creates 

relocatable 
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MANUAL: page 5-2 68000 C Cross Compiler 

NOTES: 

The preprocessor can be used for the following: 

- handling include files 

- handling user-defined macros 

- defining constants 
ex. test flags 

If <test flag> = 1 converts to 
If <test f lag> = true 

IDS (intermediate data structure) : a symbolic language which is read by the compiler to gen< 
a cryptic assembly language for a given processor. 

Reading the source code and generating the IDS is high level language dependant. This part of the compiler 
is the same for all C compilers. This part of the compiler is also the same for all Pascal compilers, yet M is 
different from the C compilers. 

Reading the IDS, generating the cryptic assembly language, and generating the relocatable are processor 
specific functions; yet are the same in the C and Pascal compilers. 
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STUDENT NOTES: 
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COMPILERS 

Types of Compilers 

• Native compilers 

• Cross compilers (HP 64000-UX) 

Compiler Libraries 

• Pre-written general purpose routines 

• Available for C and Pascal 

• Library routines can be easily linked with an absolute 

file 
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O 1967 
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NOTES: 

native compiler: this is a compiler that generates code for the host it runs on, i.e. the 68020 <' 
compiler for the 9000 series 300 computers. 

cross compiler: this is a compiler that can generate code on one host and be used on another host ».r 
compiling 68000 C code on a 68020 based 9000 series 300 computer. 

MANUAL: pages 4-1 thru 4-33 68000 C Cross Compiler 

compiler 1 ibraries: pre-written routines which can be linked with the user's relocatable code k> torm 
the absolute code. 



STUDENT NOTES: 
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COMPILERS 




Output Files of a Compiler 


• filename.R 


relocatable file 


• filename.A 


compiler symbol file 


• listfile.O 


listing file 


• ASM68000 - 


assembly file 
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MANUAL: pages 2-2 thru 2-3 68000 C Cross Compiler 

NOTES: 

The ".R" and ".A" files are created as the default of the compiler. The ".O" and the "ASM68000" files ;u< 
created only as specified by the user at compile time. 

filename.R: this is the binary relocatable file which contains the offset addresses of the source code. 

f i 1 ename . A: this file contains the line number and local symbol information for the module. 

ASM68000: this file contains the 68000 assembly language which was generated by the high level langna^ 
compiler. This file is only created if the user specifies its creation as an option to the compiler. 

MANUAL: pages 5-2 thru 5-4 68000 C Cross Compiler 

listfile.O: this is the optional listing file. The same options available in the 68000 assembler are also 
available in the compiler, such as the cross reference option for symbols. An example of this is shown on 
page 5-4 of the manual. 

The same caution applies to the compiler listing file as did the assembler listing file. 
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STUDENT NOTES: 
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COMPILERS 



Processor Directives 

• Contained in source file on first two lines 

• Syntax 

1) "C" 2) "68000" or "PASCAL" 

"68000" "68000" 

• Example 1 - is for the 68000 C Compiler 
Example 2 - is for the 68000 Pascal Compiler 
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MANUAL: pages 2-2 thru 2-3 68000 C Cross Compiler 



NOTES: 

The processor directive information MUSI be on the first line or two lines of the source code file. No M;ioi 
lines are allowed above these statements. 



The processor directive for the Pascal compiler can be exactly the same as the directive for the 68000 
assembler. 



STUDENT NOTES: 



Compilers , page TO 



HP 64000-UX Training 
□ Compilers 



COMPILERS 

Compiler Directives 


Assembly 

Pseudo-Instructions 


Pascal 

Compiler Directives 


C 

Compiler 


ORG 

GLB(GLOBAL) 
EXT(EXTERNAL) 


$ORG$ 
$END_ORG$ 

$GLOBPROC+$ 
$GLOBVAR$ 

<Proc__name>;EXTERN; 
$EXTVAR$ 


$ORG$ 
$END_ORG$ 

(all "C" functions 
are global) 
global<variable> 

external <variables, 
procedures, 
functions> 


NOTE: Most compiler directives require $EXTENSIONS ON$ to compile 
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NOTES: 

The above slide gives comparisons of the some of the common compiler/assembler directives. Consul! U>< 
individual compiler/assembler manual for a complete list of these directives. 

NOTE: to turn off "$GLOBV AR$" in Pascal use the directive "$GLOBYAR-$" or "G LOBVAR OFT". 

STUDENT NOTES: 
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COMPILERS 

Transfer Address 

• Can be defined 

- assembly language 

- C source code 

- Pascal source code 



* CAUTION! 

- only one transfer address allowed 
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NOTES: 

Both the C and Pascal compilers as well as the assembler have a unique method of determining the trans I"' 
address for a given source code module. Please make a note of these differences in the next few slides. 



Multiple transfer addresses (other than those defaulted to 0000H) will result in a warning when the HnP<r» 
attempts to assign absolute addresses to the various modules. 



STUDENT NOTES: 
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COMPILERS 


Transfer Address in C 




•c* 

•68000" 






main ( ) 






source code 
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MANUAL: pages 2-9 thru 2-10 68000 C Cross Compiler 
NOTES: 

The transfer address in the C source code is defined by the "main ()" identifier. This lets the compile 
the start of the main program is contained in this module. 

STUDENT NOTES: 
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COMPILERS 


Transfer Address in Pascal 




'68000* 

PROCEDURE <name> 
BEGIN 






END; 






BEGIN 
END 
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NOTES: 

The transfer address in the Pascal source code is defined by the: 

BEGIN 
END 

construct. This tells the compiler that the transfer address is to be defined since the main procedure V 
contained within this module. 

STUDENT NOTES: 
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LINKE 
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Linkers , page 1 
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□ Linkers 



LINKERS 

Purpose 

• Used to define address ranges of relocatables which 

will make up the absolute file 

• Generates symbol table 

Features 

• Linker command files available 

• Generates code usable with HP 64000-UX analyzers 

• "no loads" available 

• Generates cross-reference and program load map 

information 



LKUKJ O 1987 Hwtell-Paduud Company 

MANUAL: page 7-1 68000 C Cross Compiler 

NOTES: 

1 inker: used to define address ranges of the relocatables and symbolically links the relocatable modules 

The linker symbol table assigns absolute addresses to the symbols of the relocatable modules. 

no loads: files which have their symbol information loaded, but no absolute code is generated, 
example would be to use no load files with emulation memory overlays (explained later). 

The cross reference and program load map information are optional output of the linker and must 
specified by the user. 



STUDENT NOTES: 
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LINKERS 

Functional Components 

* Initialization 

- object files specified 

- libraries specified 

- relocation information 

- listing options 

- command file specified 

• Relocates global symbols 

• Generates absolute, linker symbol, and 

load map files 

* Cross reference - generates global symbol reference 

information 

LK1I.B O 1987 Hewtell-PackMd Company 

MANUAL: page 7-2 68000 C Cross Compiler 



NOTES: 

relocation information: determines where the PROG. DATA, and CO MM sections of code will 
located in physical memory. 

If global symbols are unknown in the object code during first pass of the compiler, the libraries specified a 
searched. 

If memory overlays were specified by the user, they will be flagged by the linker during the second pass 
the compiler. 

Cross reference information includes table listings of global symbols, the relocatable which defined the glol 
symbol, and the relocatable* which reference the global symbol. 



STUDENT NOTES: 
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□ Linkers 



LINKERS 




Output Files of the 


Linker 


♦ <filename>.X 


- absolute file 


* <filename>.L 


- linker symbol file 




1 1 1 1 r\ tz? 1 CUIIIIildllU lllc: 


• <listfile>.0 


- linker listing file 



LKl 1.20 
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MANUAL: pages 7-7 thru 7-10 68000 C Cross Compiler 

NOTES: 

f 7 1 ename.X : this binary file is the combination of all the relocatable files and library routines specified. 

fl 1 endive » L : this file contains the global symbol information from all the relocatable files and libn»»^ 
routines used. 

fi 1 endllie. K: this optional file is a command file containing all the information entered by the user dnnnr 
the linker initialization. 

1 i stfi 1 e.0: this is the optional listing file that contains the information requested by the user with 
use of the linker listing options. 



STUDENT NOTES: 
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LINKERS 

Linker Listing File 

• Optional but recommended 

• Syntax Ink -ox > <listfile>.0 

• .O - standard convention for listing files 

• CAUTION! - assembler/compiler listing file will be 

overwritten if <listfile> matches <filename>! 

• Options: 

- xref - symbol cross-reference listing 
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NOTES: 

When a linker listing file is specified as an option, a listing load map is generated similar to the one shown 
on page 7-7. The syntax example shown would generate linker listing file with the option "xref" turned <»n. 
An example of a cross reference table is shown on page 7-9. 

CAUTION: if the filename of the linker listing matches a filename of one of the listing files of *ln 
assembler or compiler, the assembler or compiler listing file will be overwritten! 



STUDENT NOTES: 
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LINKERS 

Linker Command Files 

• Created 

- ASCII file containing answers 

to linker questions 

- creating ASCII file with editor 

• Features 

- time saving 

- editable 

- ease of use 
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MANUAL: pages 7-4 thru 7-6 68000 C Cross Compiler 
NOTES: 

Linker command files are available so the user does not have to re-enter the same information every <«m< 
the source code is changed, and the relocatables have to be re-linked. 

The easiest method for creating a command file for the linker is by the interactive method. The questions 
asked by the linker are shown on page 7-5. The linker prompts for the relocatable and library files which 
will be used to create the absolute. It also prompts for the name of the absolute file to be used. 

A second way to create or change a linker command file is with an ASCII editor, such as Sk. The foimn* 
for the command file is given at the bottom of page 7-4. 

STUDENT NOTES: 



Linkers > page 6 



HP 64000-UX Training 
□ Linkers 



LINKER 


Example of Linker Queries 




execute Ink 






object files main.R, towers.R 






library files /usr/hp64000/lib/clib/l68000/a5_lib.R 






Load addresses: PROG, DATA, COMN, A5 2000h, 3000h, 






4000h, 5000h 






more files (y or n) y 






object files mon_68000.R 






library files 






Load addresses: PROG, DATA, COMN, A5 1000h, 0, 0, 0 






more files (y or n) n 






absolute file name main.X 
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NOTES: 

NOTE: a linker command file will be created after this session with the file name "niain.K". 

STUDENT NOTES: 
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LANGUA 


GE 


SYSTE 


M 


SUMMA1 


RY 
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LANGUAGE SYSTEM SUMMARY 

FILE TYPES 

• Source files 

.S - assembly source 
.C - C source 
.P - Pascal source 

• .R - Relocatable files 

• .A - assembler/compiler symbol files 

• .O - assembler/compiler listing files 



ISUtO 



O m7 



HewleK-Packarcl Company 



NOTES: 

The filenaming conventions for the source code and assembler/compiler listing files is not required, 
recommended. If this convention is followed, the user will find that the level of confusion will be less than 
usual. 



STUDENT NOTES: 
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LANGUAGE SYSTEM SUMMARY 

FILE TYPES 

* .L - linker symbol file 

* -O - Linker listing files 

* .K - linker command file 

* .X - object code (absolute) file 
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NOTES: 

The filenaming convention for the linker listing file is not required, but recommended. REMEMBER, do «»<>< 
give a linker listing file the same name as a assembler/compiler listing file, or the assembler/compiler lisHnr 
file will be overwritten. 



STUDENT NOTES: 
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NOTES: 

The diagram above shows the complete 64000-UX Language System and the connections betwen 
different component parts. All the files that can he generated are also shown with their respc« 
extensions or suggested extensions. 



STUDENT NOTES: 
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ASSEMBLERS 
COMPILERS 
LINKERS 
LAB 
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□ Assemblers/Linkers/Compilers Lab 



ASSEMBLERS/COMPILERS/LINKERS LAB 

Objectives 

• What is a language system 

• Functionality of an assembler 

• Functionality of a compiler 

• Functionality of a linker 

• The HP 64000-UX filenaming conventions 

» The inputs and outputs of the HP 64000-UX language 
system 



ACItIO O 198? Hwtelt-P»ckai<l ComMiry 

STUDENT NOTES: 
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HP 64000-UX Assemblers / Linkers / Compilers Lab 



Objectives: 

* understanding of a language system 

* learn basic functionality of 2m assembler 

* learn basic functionality of a compiler 

* learn basic functionality of a linker 

* the HP 64000-UX filenaming conventions 

This lab will be broken up into four major components , the language 
system introduction, the assembler, the compiler and the linker. 

The intent of the lab is to INTRODUCE the student to the language 
system tools available from Logic Systems Division which will eventually 
be used to generate the absolute code needed in the HP 64000-UX 
Development Environment. 

The program to be used with this lab is a game called "Towers of 
Hanoi 11 . This program is written in C for the most part, but does 
include a Pascal "pause" routine to show the flexibility of the 
language system. Another concept which will be introduced is the 
idea of an emulation monitor program. This program is written in 
68000 assembly language and is needed to make the 68000 emulator 
function properly. It is user-modifiable source code and needs to 
be assembled and linked before using. 

A brief description of each of the files used in the "Towers of Hanoi" 
program is shown below: 



<filename> 
mon 68000. s 
main.C 
pause. P 
tower s.C 
data 

datacomp.C 
clr display. C 
assign discs . C 
gendisplay.C 
movedisc.C 
place. C 
remove. C 
comphanoi 
all.K 



<description> implemented language> 

the 68000 emulator monitor program (assembly) 

the main routine of the Towers program (C) 

pause routine used to slow display down (Pascal) 

recursive routine for moving discs to pegs (C) 

file for setting data parameters (C) 

contains data structure for discs and pegs (C) 

routine for clearing game display (C) 

initialization routine for Hanoi (C) 

generate next display for game (C) 

procedure to remove and place discs (C) 

places disc on a given peg (C) 

remove a disc from a given peg (C) 

command file which assembles and links all module 

a linker command file used to link the relocatabl 
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The structure of how the different routines are called is shown below: 

/ main.C \ 

/ \ 
gendisplay . C towers . C 

/ \ I 

clr display . C assign discs . C move disc .c 

/ I V 
remove. C place. C pause. P 

datacomp.C loaded into memory 

data included with other modules 

mon 68000. S loaded into memory as emulation monitor 

The student will need to know how to use an editor during this lab. 
The Sk editor is probably the best choice since it automatically 
supplies line numbers in the source file. 



Language System 

[ ] Enter pmon and access the help facilities which can give you 
information on the following commands: 
edit 
compile 
assemble 
link 
log 



Assembler 

[ ] The file which will be used for this section of the lab is: 
mon 68000. S 

[ ] Enter the following command: 

"cd" to the directory to be used for the lab; "$HOME/lang". 

[ ] Enter the "pmon" software and edit the "mon 68000. S" file 
with the "sk" editor. Read the first 33 lines of the file 
to get a brief overview of an emulation monitor program. 

[ ] We will now look at several features of the assembly source code: 

1. The source code processor directive at the top of the file 
is used to define which assembler table will be used to 
generate the relocatable file. 

2. Look at the global variable declarations on lines 36-54. 
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3. Examine the "ORG 11 assembler directive located on line 61 
of the source file. The assembler will normally generate 
relocatable addresses for the code, but in the case of the 
"ORG 11 statement, the address reference made to these 
locations will be defined as absolute addresses. 

4. Another important assembler directive is located on the last 
line of the file (664) . You will notice that the "END" 
directive does not have an associated label. Without the label, 
the END directive only flags the end of the assembly routine and 
does not define a transfer address. 



Assembling the Source 

[ ] Exit the editor and save the assembly source file. 

[ ] Press the "assembly" softkey from within pmon and use the HELP 
utility to determine what the options are available during 
assembly. 

[ ] Assemble the "mon 68000. S" source code and generate a listfile for 
the output. Use the proper options so that a listing will be 
generated and you can monitor the assemblers progress Have the 
command generate a symbol cross reference as well. Name the listing 
file "mon 68000.0". 

[ ] An error should have occurred. Use an editor to fix the bug. 

[ ] Use the command recall feature of pmon ( and ) to recall 

your last assembly command and retry its execution. Verify that 
the assembly ran with no errors and no warnings. HINT: try the 
"-v" option. 

[ ] Edit the listing file. NOTE: if the listing file is empty , 

recheck the options of the "assembly" command and fix the problem- 
Page down through the listing file and pay particular attention 
to the relative addresses assigned by the assembler. Also 
notice the opcode / data fields of the source file and their 
associated code generated by the assembler. Another point-of~ 
interest are the line numbers which exist in the listing file. 

[ ] Go to the bottom of the file. Hint: search or find the string 
"CROSS" which is the header for the cross reference table. 
Inspect this table and take note of: 

- the symbols are listed in alphabetical order 

- the line number where the symbol was defined is shown 

- the type of symbol is given (p is for program) 

- all the references made to the symbol are listed by 

line number 
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[ ] One of the more important symbols for the 68000 monitor is the 
"MONITOR ENTRY' 1 symbol. Take note of how many different 
references are made to this symbol. 

[ ] Exit the editor 

[ ] If you suddenly needed to check the cross reference table for a 
specific symbol , it would be a waste of time to enter and editor 
to look at the information. Instead, a much faster and more 
efficient method of looking at this information is with the 
HP-UX command "grep". Using the "grep" command determine all the 
line numbers which are references to the symbol "MONITOR ENTRY" . 

This is a great utility for locating all the calls to a given 
symbol within a source file. 

If you need help try: "grep MONITOR ENTRY mon 68000. S | wc -1" 



Compilers 

The file which will be used for this section is: 
main.C 

[ ] Enter the pmon software and edit the source file main.C with the 
Sk editor. 

[ ] The following features exist for the compiler: 

1. Note the processor directive syntax on the first two lines 
of the file. 

2. The compiler directive "$ASMJFILE$" is used to tell the 
compiler to generate an assembly code file (ASM68000) . 

3. Note the "extern" statements on lines 13-15. These statements 
define the associated variables to be global and external 
inside this one particular source file. Notice especially 
the line with "extern towers ();" and the syntax of comments 
used by C. 

4. Take note of the "mainO" statement. This is the syntax for 
defining a transfer address in C. The transfer address will 
actually come from the library routine we will link later on. 
This library routine is discussed further in the 68000 C Cross 
Compiler manual on Pages 2-9 and 2-10. 
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Compile the C Source 

[ ] Exit the editor 

[ ] Press the "compile 11 softkey and use the HELP facilities to 
determine what options are available for the command. 

[ ] Compile the file with a listing file that has the same name with 
a ".O" extension. Specify the options so you can monitor the 
progress of the compilation, a listing will be generated, and 
a cross reference will be generated. 

[ ] A warning should have appeared. Edit the source code file and 

fix the bug. HINT: the error has to do with function declarations. 
Ask for help, if needed. 

[ ] Re-compile the source code and verify it for correctness. 

[ ] Edit the listing file and note the following features: 

- the line numbers 

- the relative addresses as generated by the compiler 

- the cross reference table which shows the symbol 

reference information for the file. 

[ ] End out of the editor and edit the file ,, 2^SM68000 n . 

- Note the comments of the file (preceded by a ,f ; fl ) are the 
source lines of the original file, including the line numbers . 

- The assembly code generated by the compiler is located directly 
below the source code comments. 

- NOTE: this is a great feature of the compiler, but only one 
compiler file can have an assembly listing per directory since 
the "ASM68000" filename is predefined. 

[ ] Exit the editor 
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□ Assemblers/Linkers/Compilers Lab 



Point out more features of the compilers 

1. Edit the file: 

pause. P 

2. Note the compiler directives on the first two lines. These 
tell the compiler that this file contains Pascal source 
code for the 68000 microprocessor. 

3. The compiler directive "^EXTENSIONS ON$" allows the Pascal 
source to contain certain extensions to the language which 
are not normally available in standard Pascal . 

4. A transfer address will be defined by this module with the 
syntax at the bottom of the source code, namely: 

BEGIN 
END. 



Compile the Pascal source 
[ ] Exit the editor 

[ ] Compile the Pascal source using the options presented for the 
C compiler. Include the listing file. 

[ ] Verify the source compiled properly. 

[ ] The listing file for this compile does not differ much from the 
listing file of a C compiler. 



Calling routines written in different source languages 

[ ] This is a major benefit of the 64000-UX Language System. 

[ ] Edit the file "move disc. C" and find the call to the Pascal 
routine called "pause". Calling other procedures without 
parameters is a trivial case, but calling with parameters is 
beyond the scope of this course . 

[ ] Exit the editor. 
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□ Assemblers/Linkers/Compilers Lab 



Linker 



[ ] Enter pmon. Press the "link" softkey followed by the "HELP" 

softkey. Read the option descriptions available for the linker. 

[ ] Prepare to link an example file by selecting the cross reference 
and output listing options of the link command. The output 
listing file should have the filename "main. map" 

[ ] Once the command on the command line is built, press the return 
key to begin am interactive linking session. As an example, 
enter the values shown below: 



[ ] This command should generate any number of "undefined symbol" 
errors. These are due to the fact that the main routine has 
symbol references pointing to many of the different modules in 
the Towers program. The only way to fix this problem is to link 
in all the appropriate relocatables at one time. 

[ ] Verify you are in your "$HOME/lang" directory and that the file 

"comp hanoi" is also in the directory. There are more modules which 
need to be compiled first. Run the script "comp hanoi" and this 
will compile the needed files for you. You may want to look at this 
file at some time because it is a good example of how to use a shell 
script as a command file to do work for you. 

[ ] At this point, you have all the necessary modules assembled and 
compiled. The next step is to link the modules together to form 
the absolute file. You cam accomplish this by using the linker 
command file already created for you. It is called: 
all.K 

This is a good exercise in that it shows you the second way a 
linking session can be performed. 

[ ] Run the linker and specify a linker listing file of "main. map" 
and use the linker command file "all.K". 



object files 
library files 
Load addresses: 
more files (y or n) 
absolute file name 



main.R 

/usr/hp64000/lib/clib/168000/a5 lib. R 

1000h,2000h, 3000h, 4000h 

n 

main.X 
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□ Assemblers/Linkers/Compilers Lab 



[ ] As you noticed, the linker gave you errors telling you that 
multiple transfer addresses were defined. In order to give 
you exposure to the syntax of transfer addresses in the different 
languages, transfer addresses were defined in the following modules: 

pause. P 

main.C 

Logically, the transfer address should reside in the "main.C" 
module. Edit the other module to remove the transfer address 
specification. Ask for help if you need to!! 

HINT: the transfer address in the Pascal routine looks like: 
END; 

BEGIN 
END. 

It should look like this without the transfer address: 
END; 



NOTE: the real transfer address will be defined in the library 
routine mention above. The 64000-UX C compilers know to include 
this routine as the transfer address so that proper functioning 
of the 64000-UX emulators can be preserved. 

Refer to pages 2-9 and 2-10 of the 68000 C Cross Compiler manual 
for more thorough coverage of this topic! 

[ ] Don" t forget, the modified file has to be re-assembled 

and re-compiled. Now try to re-link the modules using the 
"all.K" linker command file. If all is well, you have done it! ! 
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□ Measurement Systems 



MEASUREMENT SYSTEMS 
Modules 

Features 

• 64000-UX product 

• Separation by functionality 

- emulation 

- analysis 

- prom programming 

• User definable name 

• Four modules per cardcage 

• Cross-triggering with 1MB 

• Flexible grouping (measurement systems) 

- standalone 

- multiple module systems 
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MANUAL: pages 1-1 thru 1-3 HP 64000-UX Measurement Systems 



NOTES: 

module: a single 64000-UX product installed in the cardcage. 



Example modules: 
64243S 
643 1 OA 
64620A 
6461 OS 
64501A 



68000 emulation subsystem 
software performance analyzer 
state analyzer 
timing analyzer 
prom programmer 



A single module can consist of several boards, i.e. the 68000 emulation subsystem you will use in lab < onsi J 
of the following hardware components: 

64243 68000 emulation control card 

64243 68000 emulation pod 

6430 2 A Emulation bus analyzer (internal analyzer) 

641 55B Emulation memory controller with static RAM 

(or equivalent memory subsystem: 64 1 55 A and 64 I 62 A) 
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□ Measurement Systems 

1MB (inter-module bus): the 64000-tJX analyzer communication bus. Allows features swb 
driving triggers, receiving triggers, and analyzer enable signals. 

An example of 11MB connections is shown on page 1-5 of the 64000-UX Measurement System manual. 

STUDENT NOTES: 
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MEASUREMENT SYSTEMS 
Building Measurement Systems 

Features 

• Flexible grouping of modules 

• Multiple measurement systems/multiple users 

• One user can "own" each measurement system 

• Multiple cardcages per computer 

• Easy configuration commands 



O 1967 



Hewlett-Packard Company 



NOTES: 

measurement system: one or more modules connected together with an 1MB cable for the purpose <>* 
coordinating measurements between the modules. 

HP 6400G-UN limitations: 

- up to six modules can be in one measurement system 

- only one measurement system can cross between cardcages due to 

1MB cabling constraints 

- up to four measurement systems per cardcage 

- maximum of four measurement systems running simultaneously 



STUDENT NOTES: 
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MEASUREMENT SYSTEMS 
Productive Examples 

Cardcage 1 



Measurement System 1 






Emulator with 
Internal Analysis 




Measurement System 2 






Emulator with 
Internal Analysis 






[ 1MB 








t 




1MB 



Measurement System 3 






Emulator with 








Internal Analysis 






Measurement System 2 






State Analyzer 






f" 1MB 








% 




1MB 



inter-cardcaqe 1MB cable 
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MANUAL: page 1-3 Measurement Systems Manual 

NOTES: 

The above slide shows a possible two cardcage configuration which contains three emulation systems, 
of these systems also utilizes the state analyzer and the 64000-1' \ 1MB. 



STUDENT NOTES: 
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MEASUREMENT SYSTEMS 



Productive Configurations 







driven 
trigger 


Dual Emulation System 


-i Measurement 

System 


68000 Emulator 


w/64302 Analysis 


1 

1MB 

i — ► 


8051 Emulator 


w/64302 Analysis 








II 






Target System 
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NOTES: 

The above dual emulation system shows one possible interaction between a 68000 emulator and an f 
microcontroller. The 68000 can be used to detect a trigger condition and to activate the 805 1 for fuHlM - 
sof tw are debugging. 

STUDENT NOTES: 
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MEASUREMENT SYSTEMS 
Productive Configurations 



state - EBPP 







+ 


Emulation System 


«4~ Measurement 
Systems 

1MB 


Analysis System 


68000 Emulator 
w/64302 Analysis 




State Analyzer 




Timing Analyzer 





1 



Probe 



Target System 



one cardcage 



Timing 
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NOTES: 

The above slide shows the flexibility and power of the HP 64000-UX Development System, 
configuration combines the 68000 emulator with the power of the state analyzer and timing analyzer 
efficient hardware and software debugging tool. 



STUDENT NOTES: 
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MEASUREMENT SYSTEMS 

Configuration Commands 
<t msinit <-s> 
# msconfig 

msstat 

- available 

- unusable 

- running 

- locked 

m msunlock 

- can be restricted to: 

root permission 
group permission 



MSI 135 O m? HewKHt-Pactord Company 

MANUAL: pages 2-1 thru 2-9 HP 64000-UX Measurement Systems manual 

NOTES: 

MANUAL: pages 2-1 thru 2-3 HP 64000-UX Measurement Systems manual 

msinit: initializes the earclcages and all modules contained in the eardcages. 

The "-s" option is used whenever a cardcage is added or deleted from the 9000 series 300 computer, 
should also be used when changes are made to the 1MB cabling. A full list of these situations is on page 
of the manual. 



MANUAL: pages 2-4 thru 2-7 HP 64000-UX Measurement Systems manual 

WSCOnfig: a softkey driven interface which allows the grouping of available modules into measmrm 
systems. 

The "msconfig" command brings up its own set of softkeys. These commands are summarized on page 2 
the manual. 
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□ Measurement Systems 



MANUAL: pages 2-8 thru 2-9 HP 64000-UX Measurement Systems manual 

msstat: displays the status of the defined measurement systems. 

The following are possible slates of measurement systems: 
available - system is initialized and ready for use 
running - a user is running the system 
locked - a user has temporarily stopped using the system 
unusable - hardware is improperly setup or the power is off 

MANUAL: pages 3-6 HP 64000-UX Measurement Systems manual 

msunl OCk : used to "free up" measurement systems locked by other users. 

The "msunlock" command can be controlled by modifying the execution permissions of the command itsrH 
The access can be restricted to: 

"root" permission 
"group" permission 
"all others" permission 

STUDENT NOTES: 
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MEASUREMENT SYSTEMS 
Hardware Option Test 

Features 

• Easy to use 

• Locates failures in 64000-UX hardware 

• Available for cardcage 

- visual verification 

• Available for modules 

- software driven 

- visual display of results 

• Checks configuration errors 

• Pinpoints hardware failures 
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MANUAL: pages 9-1 thru 9-6 HP 64000-UX User's Guide 

NOTES: 

option test: is a program which tests 64000-UX hardware lor failures. 

Option test should be ideally performed every time a module is installed or reinstalled in (he cardca* 
should also be run if the user suspects that the hardware is the cause of operational problems. 

Option test has the ability to pinpoint a hardware failure to a specific cardcage and to a specific bo: 
that cardcage. 



STUDENT NOTES: 
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MEASUREMENT SYSTEMS 
Hardware Option Test 




ENTER OPTION TEST 

4 

SET UP TESTING MODE 

4 4 

MULTIPLE CARDCAGES SINGLE CAROCAGE 

4 4 

PRESS MULTI PRESS SLOT* 

4 

INCLUOE CARDCAGES 
ANO SLOTS 

4 

ENABLE ERRORLOG FILE 

4 

BEGIN TESTING 

4 

OBSERVE FAILURES 

4 

CALL HP REPRESENTATIVE IF FAILURES ARE FOUNO 
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MANUAL: pages 9-2 thru 9-5 HP 64000-UX User's Guide 

NOTES: 

The above flow diagram shows the steps involved in testing 64000-UX hardware. 

The methods of accessing the option test and using the option test should he discussed in the lecture (' 
Guide - Chapter 9). You will get to perform the option test on the emulation hardware in lab. 

Descriptions of the "Options Test Soft keys" are shown on page 9-5 of the User's Guide. 

STUDENT NOTES: 



Measurement S> stems, page I 1 



HP 64000-UX Training 



□ Measurement Systems Lab 



MEASUREMENT 
SYSTEMS 
LAB 
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MEASUREMENT SYSTEMS LAB 

Objectives 

* Familiarity with cardcage 

* Familiarity with module hardware 

* Board configuration 

* Measurement system cabling 

* Hardware option test 

* Creating/editing/deleting measurement systems 
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STUDENT NOTES: 
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HP 64000-UX Measurement Systems Lab 



The HP 64000-UX Measurement Systems manual is an excellent source of 
information for this lab. 

Objectives: 

* familiarity with cardcage 

* familiarity with module hardware 

* board configuration 

* measurement system cabling 

* hardware option test 

* creating / editing / deleting measurement systems 

The beginning of this lab will be a short explanation of the hardware 
associated with a measurement system, specifically the 68000 emulation 
module with internal analysis. 

The lab will be broken up into three basic parts: hardware conf iguratior , 
hardware option test, and measurement systems 
Hardware Configuration 

[ ] A look at the 64120 instrumentation cardcage 

- rear panel 

- power connector 

- voltage selector 

- fuse 

- power switch 

- HP-IB 

- connection to the 9000 series 300 

- address and XFT switches 

- external 1MB extender connector 

- BNC ports 

- inside of cardcage 

- motherboard 

- 1MB connector for bus 

- cabling grounds and restraints 

- front panel 

- power indicator 

- two self-test "passed" indicators 



Measurement Systems Lstb; |>age 3 



HP 64000-UX Training 



□ Measurement Systems Lab 



Installing the Hardware 

[ ] Installing the emulation hardware 

- inspection of the module boards and functionality 

- method of board layout (bus configuration) 

- emulation control board 

- emulation pod 

- memory system (64155B or equivalent) 

- contains both the memory controller and memory 

- internal analyzer (64302) 

- different buses: emulation bus, analysis bus, memory bus 

- installation of boards 

- memory system 

- analyzer 

- emulation control card and its connection to the pod 

- remove probe protector 

- install memory bus cable 

- install analysis bus cable 

- show possible installation of 1MB cables 

- proper emulation pod cable routing (include restraint) 

- verify proper hardware configuration 

- boards seated properly? 

- cables seated and routed properly? 

Running Option Test 

[ ] HP 64120 Option Test 

- secure power cord 

- switch power ON 

- verify cardcage option test 

- AC power indicator (bottom LED) 

- two self test lights (top two LEDs) 

[ ] Emulation Option Test 

- The option test software is accessed through the pmon 

interface. Enter pmon and press the "opt test" softkey. 

- Then read the available help messages for this level of 

softkeys. Start the options test without using any of the 
command options available. 

- Use the "help" softkey at this level to help you select the 

68000 emulator for the option test. If a message appears that 
the hardware is in use, ask for help from the instructor. 

- When no one else is accessing the hardware run the option 

test to cycle through the board set at least five times to 
verify proper hardware operation. Enable an error log file 
in the directory ,, /tmp n when running option test. 

- End the hardware option test only if no errors in the hardware 

configuration were found. 
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Building and Maintaining Measurement Systems 

[ ] Running "msinit" 

- Enter the measurement system interface software by using the 

"MEASSYS" softkey in pmon. 

- Use the on-line help facilities to determine the softkey 

functions . 

- Initialize the cardcage and module hardware as if you have jus* 

connected the cardcage to the 9000 series 300. 

- Verify no errors were found with the configuration 

- Verify displayed address matches the address set on cardcage 

with switches 



CAUTION: DO NOT run msinit when another user is running the 
hardware option test. 

NOTE: When naming measurement systems, be very careful your name does not 
match the name given by another user on the same computer. Always 
use a unique name, such as part of your login name. 

[ ] Running "msconfig" 

- execute the msconfig command 

- make a measurement system 

- type the command "help" and select the softkey associated 

with the msconfig commands. Determine the function 
of each of the msconfig commands. 

- name the measurement system "<username>", where xusername; 

is your login name. 

- name the 68000 emulation module "M68000" 

- include only the 68000 module 

- edit the measurement system 

- delete the 68000 module 

- remove the measurement system "<username>" 

- recreate a new measurement system and name it "<username>" 

- add in the 68000 module with name "hanoi" 



[ ] Running "msstat" 

- execute the msstat command 

- verify your measurement system is named properly 

- verify that your measurement system is "available" 

- if your measurement system is: 

unusable 

locked 

running 

try to troubleshoot why and remedy the situation 
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[ ] Running "msunlock" 

- enter ME AS SYS software 

- press the ,, <username> ,, softkey and then the "hanoi" 

softkey and press return 

- enter "msstat" as an HP-UX command and verify that the 

measurement system hanoi is running. Press return. 
HINT: use a »!" in front of the command to make it an 
HP-UX command. 

- when the next level of softkeys appears , press the "end" 

softkey and immediately press return. 

- The above sequence of commands will simulate a locked 

measurement system. 

- use msstat to determine the current status of your 

measurement system 

- the measurement system should now be "locked" 

- use the help facilities and msunlock to make the measurement 

system available again. 

- verify that what you tried worked 
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EMULATION 

Purpose 

• An emulator is a design tool for microprocessor-based 

systems that gives YOU visibility into the system and 
control of the system 

Features 

• Aids in software design 

• Aids in hardware design 

• Immediate insight of clock-by-clock operation 

• Emulation runs independent of operating system 

• Interacts with other 64000-UX modules 

EM1U0 O 1987 Hewleu -Packard Company 

NOTES: 

The emulator can gain insight into the processor's clock-by-clock operation by utilizing the analysis :hhI 
monitor capabilities of the emulator. 

Once the operating system (HP-UX) has loaded the appropriate 64000-UX software, the development 
system no longer requires direct intervention from the operating system. 

STUDENT NOTES: 
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EMULATION 

Emulator Features 

* Program loading and execution 

• Program stepping, run/stop control 

* Execution analysis 

• Software breakpoint generation 

• Flexible memory mapping 

♦ Real time and non-real time modes 

* Display/modification of processor resources 

* Global and local symbols display 

EM1U2 O 1987 Hewlett-Packard Company 

« 

NOTES: 

1 he software breakpoint generation feature is available in the 68000 emulator, but not available in all <lu- 
64000-1) X emulators. 

STUDENT NOTES: 
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□ Introduction to Emulation 

. 



EMULATION 

Emulators are used in one of three operating configurations 
*> Out-of-circuit emulation 

• In-circuit emulation using development system 

resources mixed with user target system resources 

• In-circuit real-time emulation using only user target 

system resources 
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NOTES: 

This course is designed with out-of-circuit emulation labs. The topic of in-circuit emulation is reserved f<» 
more advanced emulation/analysis class which customers can attend. 



STUDENT NOTES: 
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EMULATION 



Emulation vs. Simulation 


-ambition to equal or surpass 


-an appratus that generates test 


another 


conditions approximating actual 




or operational conditions 


-real time 


-non-real time 


-software runs on processor 


-software runs on host 
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NOTES: 

non-real time executi on: this applies to the idea of simulation. All the features of the emulator 
available when running in this mode. 

real time executi on: this applies to the idea of emulation. The emulator will run the users 
without interruptions from the emulation monitor program, thus some of the display / modify eommam 
the emulation monitor are prohibited. 



STUDENT NOTES: 
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EMULATION 

What is transparency? 

• Functional 

• Timing 

• Electrical 

• Resource 



EMI 125 
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MANUAL: pages 1-7 thru 1-8 8 and 16 Bit Emulation Reference 



NOTES: 

transparency: the characteristic of the emulator that the function, signal quality, signal timing, loading 
drive capacity, and other factors at the plug-in pins should be indistinguishable from the actual processor 

fundi onal transparency: the ability of the emulator to function exactly as the processor would. 

timing transparency: the ability of the emulator to preserve the timing relationships between signals 
of the actual processor and not to introduce excessive timing signal skew. 

el ectrical transparency: the ability of the emulator to preserve the electrical characteristics 
(loading) of the actual processor. 

resource transparency: the ability of the emulator to allow the user full access to all the processors 
resources, i.e. interrupt vectors, I/O ports, counters, timers, etc. 
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STUDENT NOTES: 
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EMULATION 

Hardware Components 

• Emulator control card 

• Emulation pod 

• Memory subsystem 

• Emulation bus analyzer 
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MANUAL: pages 4-1 thru 4-5 8 and 16 Bit Emulation Reference 
NOTES: 

The memory subsystem of an emulation module may consist of from one to several boards depending mimm« 
memory requirements and space limitations in the cardcage. 



STUDENT NOTES: 
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EMULATION 

Emulator Control Card 

• Hardware interface between emulator and host 

processor 

• Partial mapping of memory resources 

• Timing signal conversion 

• Interface to emulation resources 

• Slow clock detector 

• Analysis clock strobe 
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NOTES: 

The emulator control card controls the interaction between the 64000-UX software and the emulation 
hardware. 

STUDENT NOTES: 
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EMULATION 

Emulation Pod 

• Contains emulation processor, associated buffers 

and control circuitry 

• Internal clock generator 

• Address and control always driven out to target system 

• During emulation memory read access, data from target 

not allowed into pod 

• Specific to each emulated processor 
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NOTES: 

The emulation pod contains the processor that executes the code and plugs into the target system processor 
socket. 

The exceptions to the address and control information being driven out to the target system are during ;» 
processor reset or while the internal clock of the emulator is being utilized. 

STUDENT NOTES: 
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EMULATION 

Memory Subsystem 

• Consists of memory control board (with or without 

on-board memory) and up to eight memory boards 

• Maps blocks of static RAMs to processor addresses 

• Maps memory as emulation or user 

• Maps memory as RAM, ROM or guarded 

• Partial mapping of physical blocks of memory 



EMI 1.50 Q 1987 HwtM<-P»cti»rd Compaq 

NOTES: 

The memory subsystem consists of memory control board and one to eight emulation memory boards < h 
being 32K, 64K, or 128K bytes per board 

STUDENT NOTES: 
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EMULATION 

Emulation Bus Analyzer (State Analysis) 

• Dedicated, non-intrusive, real-time 

• 48 channels by 256 states deep 

• Provides hardware resources for 

- two hardware breakpoints 

- single stepping 

• Trace control available on address, data, status, 

symbols and source code line numbers 

• 1MB (intermodule bus) capabilities 

HM11.55 O 1987" HewteH-Packard Company 

MANUAL: pages 4-6 thru 4-7 8 and 16 Bit Reference Manual 

NOTES: 

The emulation bus analyzer will give the user the required state analysis and is tightly coupled U> 
emulator, i.e. functions as the 1MB source for the emulator. 

STUDENT NOTES: 
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EMULATION 

Softkeys used for Emulation 


^ run trace step display modify break end ~ ETC— 
load store stop_trc copy reset —ETC— 
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NOTES: 

A quick look at the available softkeys for a typical emulator. These allow access to the emulation 
internal analysis functions of an emulation module. 

STUDENT NOTES: 
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EMULATION 

Components of Emulation 

• Configuring the emulator 

• Program loading and execution 

• edbuild 

• Run control 

• Display/Modify commands 

• Internal analysis with emulator 

• Simulated I/O 
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NOTES: 

The components of emulation listed above are part of every 64000-UX emulator. 
Let's take a look at each one of these separately... 

STUDENT NOTES: 
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COMPONENTS OF EMULATION 

Configuring the Emulator 

• Default configuration 

• Modify configuration ( modify configurations ) 

• Clock selection 

• Restriction to real-time runs 

• Illegal opcodes 

• Memory mapping 

• Pod configuration 

» Interactive measurements 

• Configuration command file 
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MANUAL: pages 2-1 thru 2-8 8 and 16 Bit Emulation Reference 

NOTES: 

A 64000-UX emulator is supplied with a default emulation configuration which is loaded and used unless 
the user specifies another configuration. 

The user may also elect to "modify" the existing configuration and save the new configuration to be used ai 
a later date. 

The internal/external clock selection determines if the emulation processor's clock source will come from <h< 
emulation pod or the user's target system. The emulator gives the user a choice of breaking into the mo"Ho» 
if an illegal opcode is detected on the processor data bus. 

The topic of emulation memory mapping will be covered in detail later in this section. 

After answering all the configuration questions, the user has the chance to name and save the emulation 
configuration just setup. If created, the new emulation configuration file can be loaded every time the 
emulator is used, thus saving a great amount of time. 



Introduction to Emulation . page 15 



HP 640 00-UX T raining 

□ Introduction to Emulation 



STUDENT NOTES: 
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EMULATION 

Real-Time Execution 

• CPU runs at target system clock speed 

• Bus activity indentical to that of processor 

• "restrict to real-time" does two things 

- inhibits implicit breaks 

- inhibits implicit hold offs 
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MANUAL: page 2-3 8 and 16 Bit Emulation Reference 
MANUAL: pages 2-2 thru 2-4 8 and 16 Bit Emulation Reference 

NOTES: 

real-time executi on: is an advanced emulation topic and is better covered in an advanced emub<><>n 
class. 

STUDENT NOTES: 
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MEMORY MAPPING 

Features 

• Break on write to ROM 

• Default conditions 

• Processor specific questions 

• Kinds of memory 

- ROM 

- RAM 

- guarded 

• Sources of memory 

- emulation 

- target 

• Memory overlays 

EM1 1.80 G 1987 Hewlett-Packard Company 

MANUAL: pages 2-4 thru 2-8 8 and 16 Bit Emulation Reference 
NOTES: 

The emulator can be configured to break on the detection of a memory write to an address location reserved 
as ROM space. 

Some emulators may have processor specific questions such as the one which appears for the 68000 
concerning the number of significant address bits. 

The address space of the emulator can now be mapped as one of the following 
types of memory: 

- ROM 

- RAM 

- guarded 

These types of memory can also be defined to reside in one of two places: 

- emulation 

- target system 

NOTE: as an example the 68000 foreground monitor software must always be 
defined as "emulation RAM". The appropriate amount of address space 
must also be reserved for this purpose, i.e. the 68000 monitor program 
requires a 4 KBytes block of memory. 

Introduction to Emulation , page 1 8 
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Any memory space not mapped will be mapped to the memory default For instance, any memory m>< 
defined would be mapped as "guarded" if the memory default was defined as "guarded". 

Memory overlays allow the user to define one block of memory to respond to two or more sets of addresses 
This can be useful to help reduce the amount of required target system memory during development » r 
identical code were to reside in two separate memory areas. 

STUDENT NOTES: 
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EMULATION 

Memory Map Example 




Emulation memory blocks: available= 9 mapped= 7 size= 4K byte 

entry range type blocks entry range type blocks 

1 0- 2FFF ROM/EMUL 000-003 I 

2 5000- 7FFF RAM/EMUL 004-006 I 

3 10000- 10FFF RAM/USER - | 

4 FFF000- FFFFFF RAM/USER - I 

STATUS: Mapping emulation memory, default unspecified blocks: guarded «»«R*a« 

<AODR> default delete print end 

^ ) 
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NOTES: 

The general screen format of the memory mapper is shown in the above slide. 

The screen will list the range of the address mapping as well as the type of memory the space is mapped <<». 
It also keeps track of the number of memory blocks which have been allocated. 

STUDENT NOTES: 



Introduction to Emulation , page 20 



HP 64000-UX Training 



□ Introduction to Emulation 



EMULATION 

Configuring the Emulator 

• Pod Configuration - allows user to modify configuration 

of processor control lines 

• Interactive Measurements - allows user to set 1MB 

triggering and BNC port configurations 

• Configuration Command File - user has opportunity to 

save emulator's current configuration in a reusable file 

- creates filename.EA - ASCII configuration file 
filename.EB - binary configuration file 
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MANUAL: Chapter 5 Emulation Configuration 68000 Emulation Manual 
NOTES: 

pod configuration: these questions are specific to every emulator and will not be covered for 
68000 due to the complex nature of them. 

interactive measurements: this portion of the configuration is to allow the user to define how 
1MB is going to be used between other analyzers and whether or not any signals will be accepted 
configured for the BNC ports on the cardcage. 

configuration command file: saves the emulators current configuration in a binary file vvhk* 
loaded into the emulator to set the configuration and also saves the configuration in an ASCII file whirl 
editable by (lie user. 

STUDENT NOTES: 
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EMULATION 

Components of Emulation 

• Configuring the emulator 

W * Program loading and execution 

• edbuild 

• Run control 

• Display/Modify commands 

• Internal analysis with emulator 

• Simulated I/O 
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STUDENT NOTES: 



Introduction to Emulation , page 22 



HP 64000-UX Training 

□ Introduction to Emulation 



COMPONENTS OF EMULATION 

Program Loading 

• Loading the absolute 

- emulation memory 

- target memory 

• Foreground monitor must be loaded before loading user 

memory 

- this function is performed automatically if the 
monitor is linked with the user's relocatables 
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NOTES: 

When a "load memory" command is issued, the memory map in the emulation configuration determines wIm mt 
the absolute code is to be loaded; either in emulation memory or target system memory. The emulation 
control board contains the emulation memory mapper which takes care of this feature. 



STUDENT NOTES: 
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EMULATION 

Components of Emulation 
» Configuring the emulator 

* Program loading and execution 

• edbuild 

* Run control 

• Display/Modify commands 

* Internal analysis with emulator 

• Simulated I/O 
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STUDENT NOTES: 
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COMPONENTS OF EMULATION 

edbuild 

• symbolic database builder 

• run automatically when needed 

• best to invoke within a command file or makefile 

• .Y - database file created 

• Very large symbol files are available 
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NOTES: 

edbuild: reads files produced by the language system and produces a database used by 64000-UX 
products that provide symbolic access, such as emulation and analysis. 

Edbuild is run automatically whenever an access from an emulator or analyzer requires symbolic 
information. The builder creates the database file only as changes are made to the source code. 

Although edbuild will run automatically, it is most efficient to invoke in a makefile so that it is only run 
during compilation and linking and only as needed. 



STUDENT NOTES: 
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EDBUILD 



moduletA 



module2.A 



module3.A 



• module name 
■ local symbols 

• line number 
symbols 
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- global symbols 
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NOTES: 

The above diagram shows the input files to the edbuild program and the type of information contained in the 
".Y" file. 



STUDENT NOTES: 
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NOTES: 

This diagram shows the entire software development process, from creating the source files with an editor to 
loading the object code into the emulator. 

NOTE: all types of files with their representative file extensions are shown. 

STUDENT NOTES: 
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EMULATION 

Components of Emulation 

• Configuring the emulator 

• Program loading and execution 

• edbuild 

^ • Run control 

• Display/Modify commands 

• Internal analysis with emulator 

• Simulated I/O 
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STUDENT NOTES: 
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COMPONENTS OF EMULATION 

Run Control 

• Use of an emulation monitor 

• Run [from] / [until] . 

• Single stepping 

• Break on trigger condition 

• Software breakpoints 

• Reset (user and/or system) 
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NOTES: 

run [from] / [until ] : allows the user to run from the transfer address of the absolute code or from 
any one address to another address inside the address space of the absolute code, step [number] : allows 
the user to single step the processor for one or more instructions. This is useful while displaying the 
processor's registers to help debug the target system hardware and software. 

break: this is used for control transitioning between the user's code and the emulation monitor program. 

reset: a processor reset can be issued from the target system or from the softkey command within the 
foreground monitor of the 68000. This condition will cause the emulation processor and the emulation 
hardware to be reset. 
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STUDENT NOTES: 
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EMULATION 

Monitor Programs 

• All emulators have monitors 

• Access to emulation features 

• Link between 64000-UX and emulation processor 

• Different functional routines 

Types of Monitors 

• Background 

• Foreground 
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MANUAL: pages 6-1 thru 6-13 68000 Emulation W/lnt. Analysis 



NOTES: 

monitor program: the program which seizes control of the user's program and makes available the 
feature set of the emulator. 

background monitor: a 64000-UX system program which is not modifiable by the user. This program 
seizes control from the user code when a break or reset condition is issued. A background monitor is used by 
the 6801 emulator. 

foreground monitor: a monitor written in the processors assembly code and made available to the user. 
This type of monitor must be assembled and linked with the user's source code for the emulator to function 
properly. It gives the emulator the ability to have software breakpoints as well as the ability to access 
target memory without having to reset the processor. The 68000 emulator utilizes this type of monitor 
which adds to its functionality. 
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STUDENT NOTES: 
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EMULATION 

Monitor Program - Background 

• Typically used on processors with smaller address space 

• No memory space required 

• Resides in hidden RAM on emulation control board 

• Dynamically loaded by host processor 

• No processing of control inputs while in background 
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MANUAL: page 4-2 8 and 16 Emulation Reference 
NOTES: 

When a "background" emulator is "running in the monitor", it is actually running in the memory (RAM) on 
the emulation control board. 

When running in background, the execution of the user's processor is suspended and the processor appears 
halted to the user system. 

The memory space occupied by the monitor is not in the user's address space. This memory is accessible to 
both the emulation processor and the HP 64000-UX host processor. 

Background emulators are usually simple processors with small address spaces and no opcode pre-fetch 
ability. 



STUDENT NOTES: 
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EMULATION 

Monitor Program - Foreground 

• Typically used on processors with larger memory space 

• Needs to be located in emulation RAM 

• Can be located anywhere in address range 

• Program is simple-no complex interaction with hardware 

• User modifiable; supplied as source-therefore can 

accomodate unique system requirements such as: 

- Memory management 

- Word only reads/writes 

• Control inputs serviced while in monitor (interrupts) 

EM12JO O 1967 HwMt-eadota Convoy 

NOTES: 

A foreground monitor is located in an unused portion of the user's address space. The memory space where 
the monitor resides must be mapped as emulation memory so that the 64000-UX software and the emulator 
processor can access it. 

The foreground monitor is supplied to the user in source code form. This allows the user to customize the 
monitor to the specif ic needs of the project. 

STUDENT NOTES: 
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EMULATION 

Control Transitioning 

• The transition from the user's program to the emulation 

monitor routine 

• Defined to be a "break" 

• Techniques 

- jam instruction and make transition to monitor 

- share non-maskable interrupt to divert execution 

- software breakpoints 
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NOTES: 

break: the break allows the control of the emulator to be passed from the user's code to the emulation 
monitor. It is usually implemented in different ways with each processor, due to the processor's resources 
and control lines. 

STUDENT NOTES: 
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EMULATION 

Control Transitioning 
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NOTES: 

This diagram gives a good indication as to where the monitor resides and how the control is "transitioned" 
between the user code and the monitor. 



STUDENT NOTES: 
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EMULATION 

"Break " Resources 

• 68000 

- Level 7 interrupt (NMD 

• 8086/88 

- Type 2 interrupt (NMI) 

• Z8001/2 

- Use jam of system call instruction 
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NOTES: 

Once again, "breaks" to the monitor are implemented differently for different processors depending upon the 
resources of the processor, such as control lines. 

For example: the 68000 uses the Level 7 interrupt (NMI) to transition into the monitor program. This is 
called resource sharing. 



STUDENT NOTES: 
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EMULATION 

Emulation Subsystem Connect/on to Target System 



Em ulation Pod , — Address Bus Buffers 




EMULATION MEMORY 



SWITCH OPEN OR 

CLOSED VIA 
MEMORY MAPPING 



TARGET SYSTEM 
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NOTES: 

This diagram gives a good view of the type of connection the emulator has with the user's target system. 
Pay close attention to the address and data bus structure of the diagram and how these busses can be 
isolated from the target system if necessary. 



STUDENT NOTES: 
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EMULATION BLOCK DIAGRAM 
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NOTES: 



emulator probe: 
emulation controller: 
memory controller: 

emulation memory: 
internal analysis: 

target system: 



contains the emulation processor, buffers, and 
control circuitry. 

converts the processor timing signals to 
standard 64000-UX timing signals, 
controls the dual port memory shared by emulation 
and the 64000-UX system. Also contains the system 
address mapper. 

consists of the memory available to the user during 
emulation. 

captures address, data, and status information. Can 
also be used to cause a breakpoint on the occurrence 
of a specified trigger. 

represents the system under design which probably 
contains a processor, control circuitry, memory, and 
I/O circuits. 
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STUDENT NOTES: 
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EMULATION 

Split Emulation Bus Architecture (68000) 
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NOTES: 

Pre-fetching of instructions makes analysis more difficult. The "split bus" architecture allows only the valid 
(executed) information to be seen by the analyzer. The emulator usually also has a feature which allows the 
user to decide whether the pre-f etch instructions should be stored or filtered by the analyzer. 



STUDENT NOTES: 
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EMULATION 

Monitor/Host Communication 

• Host software communicates with emulation memory 

via "dual port" emulation memory 

• Commands and/or data exchanged via control locations 

identified by global symbols in the monitor program 
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NOTES: 

The host processor communicates with the emulation processor by transferring data to and from emulation 
memory. Data transfer is accomplished through the memory control board into the static RAM board. 
There are three global symbols (except 8051) that identify control locations to exchange commands or data. 
The following slide will illustrate these symbols. 



STUDENT NOTES: 
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EMULATION 



Monitor/Host Communication 

• MONITOR_REGISTERS - data area reserved for 

storing contents of 
emulation processor register 

• MONITOR__CONTROL - a single word location in each 

monitor where commands/- 
handshakes are read or written 

• XFER_JBUF - data buffer of 128 words where host 

computer reads data 
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NOTES: 

Processor data register storage is located at MONITORREGISTERS. Command and data transfers are 
controlled by the symbols, MONI TOR CONTROL and XFERBUF. Commands from the host processor 
are written into MONI1 ORCONTROL. XFER BUF is the location of the RAM buffer where the host 
exchanges data. Unless all three symbols are found, the emulation monitor will not be recognized. 



STUDENT NOTES: 
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EMULATION 



Emulation Processor "hold off 

• Emulation memory is dual port (host and emulation 

processor) 

• Typically last 40 usee per access 

• This occurs on every emulation memory access by the 

host processor 
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NOTES: 

Since the time between memory cycles in most emulators is very short, emulation memory cannot be used as 
a dual-port memory. Thus the emulation processor must be "held off" to access emulation memory. The 
user's target system sees nothing but what appears to be internal bus cycles. The "hold off" is usually 
implemented using the DMA control lines. The following slide gives some specific examples of what control 
lines certain processors use to implement this. 



STUDENT NOTES: 
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EMULATION 

"Hold off Implementation 

• Emulation processor halt lines used for "hold off" 

functions 

• 68000 - Bus request 

• 8086/88 - Request/Grant 

• Z8001/2 - Stop 

• 80186 - HOLD/HLDA 
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STUDENT NOTES: 
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EMULATION 

Components of Emulation 

• Configuring the emulator 

• Program loading and execution 

• edbuild 

• Run control 

• Display/Modify commands 

• Internal analysis with emulator 

• Simulated I/O 
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STUDENT NOTES: 
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COMPONENTS OF EMULATION 

Display/Modify Commands 

• Registers 

• Memory 

• Symbols 

• I/O Ports 
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NOTES: 

display regi Sters : (page 4-16) this command is usually used in conjunction with the single step 
command. This allows the user to view the most minute changes in the registers from one instruction to the 
next. 

display / modify memory: (page 4-15) these commands give the user the flexibility to view and/or 
modify any addressable memory location(s). This feature would allow the user to modify I/O port control 
registers without having to write and assemble the otherwise necessary source code. 

displ ay local / global symbol s: the user can display the local and global symbols of his code to 
determine their absolute addresses. The global symbols can then be used is setting up measurement 
specifications (symbolic debugging). 

displ ay / modify I/O ports: this can be helpful when checking the status of the target system or 
when setting up the control hardware of the target system. 



STUDENT NOTES: 
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EMULATION 

Displaying Global Symbols 

• Symbols always available during emulation for symbolic 

debugging 

• Symbol database file contains a list of each symbol, 

its location and its content 

Displaying Local Symbols in a File 

• Also available during emulation 

• File which contains symbol(s) must be specified 

• Line numbers are treated as local symbols for source 

line referencing 
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NOTES: 

The ability to display global and local symbols gives 64000-UX one of its many features: symbolic debug. 
The actual symbol name can be used instead of a specific address. Another feature called "source line 
referencing 11 is possible considering the assembler/compiler uses each line number as a local symbol. 



STUDENT NOTES: 
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EMULATION 

Displaying/Modifying Registers 

• Provides register information 

• Can be modified if necessary 

Displaying Memory 

• Verify program is correctly loaded into memory 

• Can be modified if necessary 

• Multiple display formats available 

- mnemonic 

- hexidecimal 

- blocked bytes/words 

• Repetitive display also available 

EMI 2.95 O 1987 Harielt-PMianl Company 

NOTES: 

With the ability to specify a range when using some of these commands, the user can modify entire sections 
of memory with one easy command. 

STUDENT NOTES: 
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EMULATION 

Components of Emulation 

• Configuring the emulator 

• Program loading and execution 

• edbuild 

• Run control 

• Display/Modify commands 

• Internal analysis with emulator 

• Simulated I/O 
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STUDENT NOTES: 
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COMPONENTS OF EMULATION 

Available Analyzers 

• State Analyzer 

• Timing Analyzer 

• Software performance analyzer 

• Emulation bus analyzer 

(internal analyzer) 
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MANUAL: pages 5-1 thru 5-10 8 and 16 Bit Emulation Reference 

NOTES: 

state analyzer (64620): this analyzer is used as a software debugging tool, utilizing its extensive 
trace / displaying capabilities. The state analyzer has up to 120 10MHz data acquisition channels and up 
to 8 10 MHz clock acquisition channels. 

timing analyzer (64610): this analyzer is used to debug hardware problems associated with targe* 
system timing. The timing analyzer has up to 32 200MHz timing acquisition channels. 

software perfo rmance anal yzer (643 10) : used to measure program activity and module duration. 

NOTE: these analyzers are beyond the scope of this course. Advanced training and SE (Systems Enginn i > 
consulting is currently available for all these products. 

i ntema 1 ana 1 yzer (64302): used in conjunction with an emulator to provide productive emu la Hon 
bus analysis. The functionality of this analyzer will be covered in some detail in this course. 
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STUDENT NOTES: 
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EMULATION BUS ANALYZER 

Features 

• Tightly coupled to emulator 

• Flexible trace specifications 

• Starting and stopping trace 

• Displaying trace data 
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NOTES: 

The internal analyzer board is the most tightly coupled board to an emulation system because it functions ;\u 
the 1MB source for the emulator. 

The internal analyzer gives a flexible set of trigger conditions which can be combined to produce effic«rn< 
and effective measurements. Some of these features include: 

trace after / about / before / only commands 

address / data / status triggers 

don't care (x) specifications 

OR and AND operators in trace specifications 

absolute and relative time counters 

multiple formats for displaying trace data 

1MB connection to other 64000-UX analyzers 

STUDENT NOTES: 
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EMULATION BUS ANALYZER 

Functions of the Analyzer 

• Tracing program flow 

• Triggering the analyzer 

• Tracing execution times 

• Program stepping 

• Hardware breakpoints 

• Software breakpoints 
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NOTES: 

The internal analyzer is used to monitor the address, data, and status busses of the emulator in real-time. 

The internal analyzer has many nice features listed above which can be used in combination with each other 
to make the analyzer an even more powerful tool. 

STUDENT NOTES: 
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EMULATION BUS ANALYZER 

Tracing Program Flow 

• Used to observe real-time program flow 

• Monitors address, data, and status busses of processor 

• trace command stores 256 states in memory 

• display trace in absolute or mnemonic formats 

- symbol displays possible 

- source code displays possible 

• Measures the execution time of an instruction 

- relative 

- absolute 

EM13.K) 0 1987 Hewlett-Packard Company 

NOTES: 

Two of the nicest features of the internal analyzer are the ability to display data in multiple formats and 
the time stamping of user code. The execution time counter even has the ability to display execution times 
of user's code in relative or absolute format. 

STUDENT NOTES: 
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EMULATION BUS ANALYZER 

Triggering the Analyzer 

• Trigger condition 

- address pattern 

- data pattern 

- status pattern 

- can be "ORed" for up to two trigger conditions 

• Trigger position is flexible 

- beginning - trace after 

- middle - trace about 

- end - trace before 

• Trigger buffer 

- stores up to 256 data sets 

EMI 3.15 O 1967 HwfMt-Packaid Company 

NOTES: 

The ability to flexibly trigger the internal analyzer makes it a very powerful debugging tool. Depending <>" 
what data the user wishes to capture, the analyzer is equipped to accept almost any combination of trigger 
condition and trigger position. Many of these features will be learned about in the lab. 

STUDENT NOTES: 
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EMULATION BUS ANALYZER 

Tracing Execution Times 

• trace only used to trace a specific pattern 

• Trace buffer stores up the 256 events of the specific 

pattern 

» Relative time - length between subsequent events 

• Absolute time - accumlation of length of time of 

events 

• stop_trc used to display trace if 256 events have not 

yet occurred 
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NOTES: 

The ability of the internal analyzer to trace execution times makes it a fantastic tool for testing timing 
loops in software. 



STUDENT NOTES: 
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EMULATION BUS ANALYZER 

Program Stepping 

• step used to sequence slowly through a section of 
code 

« A single step is performed by 

- loading the analyzer with the next PC 

- forcing a "break" into the monitor upon recognition 
of the PC 

• Subsequent steps are performed in this same way 
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NOTES: 

The step instruction is another extremely important feature which would not be possible without the Internal 
analyzer. The analyzer is used to set a trigger point to the next program counter (PC) and force a br«?a.l< 
into the monitor program when it detects the next PC 



STUDENT NOTES: 
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EMULATION BUS ANALYZER 

Hardware Breakpoints 

• Uses analyzer hardware to detect trigger condition 

and forces execution into the monitor 

• Can be implemented by the following commands: 

- trace <measurement> break_on trigger 

<address> 

- run until <data> 

<status> 

• Up to two hardware breakpoints possible 
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NOTES: 

A breakpoint is a predefined stopping point A hardware breakpoint causes execution to be transferred to 
the monitor as soon as the detection of the trigger pattern occurs. 

The "run until" command performs the same function as if the user had explicitly specified to break w to 
the background after meeting a trigger condition. 



STUDENT NOTES: 



Introduction to Emulation , page 59 



HP 64000-UX T raining 
□ Introduction to Emulation 



EMULATION BUS ANALYZER 

Software Breakpoints 

• Performs a "break" on detection of any valid opcode 

address 

- numbers 

- expressions 

- symbols 

• Cannot set software breakpoints in user ROM 

• Execution is resumed at breakpoint address with a 

"run" or "step" command 
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MANUAL: pages 4-11 thru 4-13 68000 Emulation w/lnt. Analysis 

NOTES: 

Software breakpoints are an extremely useful feature, but not every 64000-UX emulator has the ability (o 
use them. A software breakpoint Is implemented in the user code as a software interrupt 

The software breakpoint must be set at an address which is the opcode of an instruction. If it was set in <h< 
middle of the data operand of an instruction, terrible things might happen. 

STUDENT NOTES: 
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EMULATION BUS ANALYZER 

How Software Breakpoints Work 

• Code at breakpoint saved in a table 

• Software interrupt replaces code at breakpoint 

• Execution of software interrupts causes "breaks" into 

the monitor 

• Code from table is restored 

• PC is set to breakpoint address 
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NOTES: 

The implementation of a software breakpoint is easy to understand. The user specifies a location that h« 
wishes to be the software breakpoint (on an opcode). The real opcode at the location is stored in a table ;»«»«' 
replaced with a software interrupt opcode. When the user executes the code and hits a software interrupt 4 
break is caused and control is transferred to the monitor. The real opcode is then replaced in its origin;*! 
location and the PC is decremented accordingly. 



STUDENT NOTES: 
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EMULATION BUS ANALYZER 

Setting Software Breakpoints 

* modify software_breakpoints set <breakpoint> 

to set the breakpoint to a specific opcode address 

• modify software_breakpoints clear to remove any 

set breakpoints 
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NOTES: 

Setting up and modifying software breakpoints can get to he an involved process. For the 68000, a spcciO* 
trap address has to be picked and commented out of the monitor. The process is simple from the stand poin< 
of "modify ing tf the breakpoint to a specific address or removing a software breakpoint. Once again, this is ;> 
very powerful feature of the 64000-UX program development environment. 



STUDENT NOTES: 
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EMULATION 

Components of Emulation 

• Configuring the emulator 

• Program loading and execution 

• edbuild 

• Run control 

• Display/Modify commands 

• Internal analysis with emulator 

• Simulated I/O 
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STUDENT NOTES: 
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COMPONENTS OF EMULATION 

Simulated I/O 

• Definition 

• Standard input 

• Standard output 

• Standard error 

• Performing Simulated I/O 

- keyboard 

- files 

• Displaying Simulated I/O 

• For more information: 

- Simulated I/O Operating Manual 

HP P/N 64801-90904 
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NOTES: 

Simul ated I/O: a process which allows your emulation system to communicate with HP 9000 files 
your workstation keyboard and display. Simulated I/O also allows your emulation system to o\e< m<* 
HP-UX commands, and thus can communicate with other 9000 series 300 devices, such as printers, ploHrr . 
modems, etc. 

Simulated I/O can be tied into and redirect the standard output, standard error, and standard input devi< < :> 
of the 9000 series 300. This allows the user to effectively redirect the input and output of his tsvu* 
system program to the keyboard and display of the 9000 series 300. 

This topic is beyond the scope of this course. Further training on simulated I/O can be obtained by tflk»«»r, 
an advanced emulation course. 

STUDENT NOTES: 



Introduction to Emulation , page 64 



HP 64000-UX Training 



□ Introduction to Emulation 



SIMULATED I/O 

Emulation System Request 


CONTROL ADDRESS ► 

CA BUFFER^ 

V 


CA 
CA + 1 
CA + 2 

CA + n-1 
CA + n 
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NOTES: 

Communications between your emulation system and HP 9000 files takes place through contiguous hyi 
length emulation system memory locations. The first memory location is called the Control Address '■■(< A >. 
The Control Address and the memory locations which follow it are referred to as the CA buffer. 

The Control Address (CA) buffer should be located in emulation RAM. It is possible, however, for the < '. 
buffer to be located in target system RAM, but there will be a performance penalty for doing so. 

Emulation System Request: 

(1) Simulated I/O command parameters are first placed into the appropriate CA buffer locations. 

(2) After the CA buffer is loaded with simulated I/O command parameters, the command code is pb»< <> 
into the Control Address (CA) to cause the execution of the command. 

STUDENT NOTES: 
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SIMULATED I/O 

HP 64000-UX Response 




CA 
CA + 1 
CA + 2 

• • • 

CA + n-1 
CA + n 


< CONTROL ADDRESS 

\ 

S> CA BUFFER 
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NOTES: 

HP 64000-UX Response: 

(1) Before returning a value to the Control Address, some simulated I/O operations return additional 
information to the CA buffer. 

(2) If the operation was successful, a 00H is returned to the Control Address. If the operation was no* 
successful, an error code is returned to the CA. 

STUDENT NOTES: 
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SIMULATED I/O 

Configuation 

* Within emulation configuration 

* Define 

- polling for simulated I/O 

- up to six control addresses 

- redirection of standard input, standard output, 
and standard error 

Restrictions 

* Limit of 12 open files at one time 

* Up to 4 active simulated I/O generated HP-UX commands 

- one for standard input 

- one for standard output 

- one for standard error 

n3M O 1987 HewteU-Packard Company 



NOTES: 

The simulated I/O subsystem must be set up by answering a series of configuration questions. II 
questions are a part of the general emulation configuration. They deal with enabling simulated I/O, set* 
the control addressees), and defining files used for standard I/O. 



If each of the maximum of four simultaneous simulated I/O processes has files for standard input stand 
output, and standard error: then the maximum of 1 2 files open simultaneously is understandable. 



STUDENT NOTES: 



Introduction to Emulation , page 67 



HP 64000-UX Training 



□ Emulation Lab 




EMI 3.70 



O 1967 Htwtott-Packartf Company 



Emulation Lab , page 1 



HP 64000-UX Training 



□ Emulation Lab 



EMULATION LAB 

Objectives 

• Familiarization with hardware 

• Preparing software for emulation 

• Accessing emulation 

• Emulation run control 

• Display/Modify options 

• Internal analysis operation 



EMI3.W 



O 1967 HMtotl-Packacd Company 



STUDENT NOTES: 
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HP 64000-UX EMULATION LAB 

Objectives: 

* prepare the absolute code for emulation 

* accessing the emulator 

* emulation run control 

* display / modify options 

* internal analysis operation 

The program to be used with this lab is a game called "Towers of 
Hanoi 11 . This program is written in C for the most part, but does 
include a Pascal "pause" routine to show the flexibility of the 
language system. Another concept which will be introduced is the 
idea of an emulation monitor program. This program is written in 
68000 assembly language and is needed to make the 68000 emulator 
function properly. It is user-modifiable source code and needs to 
be assembled and linked before using. 

A brief description of each of the files used in the "Towers of Hanoi" 
program is shown below: 



<filename> 
mon_68000.S 
main.C 
pause. P 
towers . C 
data 

data comp.C 
clrdisplay.C 
assign discs . C 
gen display . C 
movedisc.C 
place.C 
remove. C 
comphanoi 
all.K 



<description> < implemented language> 

the 68000 emulator monitor program (assembly) 

the main routine of the Towers program (C) 

pause routine used to slow down the output (Pascal) 

recursive routine for moving discs to pegs (C) 

file for setting data parameters (C) 

contains data structure for discs and pegs (C) 

routine for clearing game display (C) 

initialization routine for Hanoi (C) 

generate next display for game (C) 

procedure to remove and place discs (C) 

places disc on a given peg (C) 

remove a disc from a given peg (C) 

command file which assembles and links all modules 

a linker command file used to link the relocatables 



The structure of how the different routines are called is shown below: 

/ main.C \ 

/ \ 
gen display . C towers . C 

/ \ i 

clr display. C assign discs. C move disc. C 

/ I \ 

remove. C place.C pause .P 

data comp . C loaded into memory 

data included with other modules 

mon 68000.S loaded into memory as emulation monitor 
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The student will need to know how to use an editor during this lab. 
The Sk editor is probably the best choice since it is easier to use 
and learn then the Vi editor. 

Windowing is a neat feature of the 9000 series 300 and it is recommended 
that you use the Windex (HP 9000 Windows) during the lab. 
You start the Windex system by typing the "wmstart" command from an HP-UX 
prompt; only on a medium or high resolution bit-mapped display. 

The X Window system may also be available. Type the command "xstart" 
at an HP-UX prompt; only on a medium or high resolution bit-mapped display. 
Since the X Window system is an option for HP-UX, it may not be available 
on your 9000 series 300 computer. 

Manuals for both the windowing systems are available as part of the 
training course. The use of either windowing package may degrade the 
system performance. If you need help with windows, ask the instructor. 



The lab will be broken into two major sections: the features of emulation 
and the troubleshooting section. 



Prepare absolute code 

[ ] Enter pmon and change directories to the "SHOME/emul" directory. 

[ ] A command file for compiling all of the necessary files has been 
provided for you. Take a look at comphanoi and take notice of the 
options that are used for compiling the source files. 

What do each of the options do for you? 

What is the .0 file that is at the end of each line? 

[ ] Use the linker command file supplied (all.K) to link the relocatables - 
The absolute file will be named "main.X". You should generate a 
linker listing file. Use the following command to do this: 

Ink -ox all.K > main. map 
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Accessing Emulation 

[ ] Enter the measurement system software and setup a measurement system 
including only the 68000 emulator. Name the measurement system 
fl <usemame> 11 and add the 68000 module naming it "hanoi". NOTE: the 
"<username>" name refers to your login name. 

[ ] When you exit "msconfig" you will notice that the name of the 
measurement system you created shows up. Enter this measurement 
system by pushing the appropriate softkeys. 



AVAILABLE HELP!!! 

[ ] This is a very important point. Inside the measurement system (when 
you have entered the emulation software) , you have detailed on-line 
help for the commands of the emulator and analyzer. This is a 
primary source of information during the lab and also as you use 
64000-UX later. This help contains the following information sections: 

Syntax 

Function 

Default Values 

Examples 

Parameters 

Description 

You can access this help by typing the word "help" on the command line 
and pressing the appropriate softkey for the help you desire. As an 
exercise, find the information concerning ending out of the measurement 
system by typing the word "help 11 , pushing the "end" softkey and hitting 
the carriage return key. 



Modifying the emulation configuration 

[ ] The first task to do once you enter am emulator is to define its 
specific configuration. This can be done in a few ways. The first 
is to load an already defined configuration file. The second way is 

to well why don't you find out! HINT: use the on-line help 

facilities; specifically type the command "help" and see what happens. 

[ ] Modify the configuration so that it appears identical to the one shown 
on the next page. Save this configuration in a file called "main" . 
Ask the instructor for help if you need it. 

NOTE: when you modify the emulation conf igurat ion , the questions ask 
will match the ones shown below, but may not be in the exact 
same order. 
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# 

# LSD:@(#) 3,11 86/09/23 

# @ (mktid) 01.00 
# 

# 

# This is an emulation configuration file 

BEGIN MEMORY MAP 

default guarded 

OH thru 01FFFH emulation ram 

02 00 OH thru 02FFFH emulation ram 

END MEMORY MAP 

Micro-processor clock source ? internal 

Micro-processor clock rate greater than 10 MHz ? no 

Restrict to real-time runs? no 

Number of significant address bits? 24 

Break processor on write to ROM? yes 

Interlock emulator DTACK with user DTACK ? no 

Enable Bus Error on emulation memory accesses ? no 

Enable emulator processor interrupts? yes 

Enable emulator DMA transfers? no 

Trap number for software break (0..0FH)? 0000FH 

Enable emulator use of INT7? yes 

Enable Interrupt level 7 sharing ? yes 

Enable tri state delay on halts ? no 

Enable break on halt line? enable 

Enable polling for simulated I/O? no 

Simio control address 1? SIMIOCAONE 

Simio control address 2? SIMIOCATWO 

Simio control address 3? SIMIOCATHREE 

Simio control address 4? SIMIO CA FOUR 

Simio control address 5? SIMIOCAFIVE 

Simio control address 6? SIMIOCASIX 

File used for standard input? /dev/simio/keyboard 

File used for standard output? /dev/simio/display 

File used for standard error? /dev/simio/display 

If problems arise later in the lab with the 68000 emulator, make sure your 
conf igurat ions match the one shown above EXACTLY! I 

[ ] As a test to see if the file was stored, use the "load" command 
to reload the emulation configuration . This should be the exact 

configuration you just created. 
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Loading the Absolute 

[ ] The absolute file you created above was named "main.X". Use 
the ••load" command to place this program into emulation memory. 

[ ] As you noticed , a message came up and said "Rebuilding symbol 

data base". This was the edbuild command creating the symbol file ( . Y) 
used by the emulator and analyzers in 64000-UX. This command should 
be run after linking the absolute for convenience, but will be run 
automatically when (1) it doesn»t exist or (2) when the user specifies. 

[ ] Use the "display registers" command and look at the program counter 
to determine what the transfer address of the absolute is. This will 
be the PC register and should have a value of 1034h. If your value 
differs by a small amount, it probably will create any problems. If 
it differs by a large amount, attempt to determine what the problem is. 



FEATURES OF EMULATION 
Emulation Run Control 

[ ] Use the command "run from transfer address" to begin executing the 
code. You could also substitute the specific address for the 
transfer address if you were debugging code. Look at the other 
features available under the run command; specifically the "until" 
construct of the run command. Try this out and see what happens. 
You have the flexibility to use an "address", "data", or "status" 
break point in the case of the "until" option. 

[ ] Press the "break" key. Now use the display registers command like 
you did before. You will now see one of the nicer features of the 
emulator, namely program stepping. Use the step command to begin 
stepping through the code beginning from the transfer address. Notice 
how the registers change as a step is performed. Try out the different 
options available to the step command. For more information refer 
to the on-line help utility. 

[ ] Differences between the "break" and "reset" keys 

reset - actually pulls the reset line of the processor and puts it 

into a reset condition, 
break - issues an NMI to the processor and saves the registers for 

further use. You have the ability to resume running the 

user program when this option is used. 
For more information refer to the emulation manual • 
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[ ] The "trace" command and "stop trc" command are available when using 
the 64302 internal analyzer • Perform the following measurement: 

trace about data 34h status write 
run from transferaddress 

You will notice that the trace will finish. Use the "display" command 
to see the results of the trace. The power of the analyzer has not 
yet been fully shown. 

[ ] Issue a break to the emulator and force it into the foreground monitor. 

[ ] Perform the same trace again but add the option to break into the 

monitor when the trigger condition is found. If you didn't issue the 
"break" command before setting up the new measurement, the trace would 
have completed automatically and at the wrong point since the emulator 
continued to run the code after the last trace. The analyzer merely 
"bus steals" the needed information and does not interfere with the 
operation of the emulator unless the user desires • 

After the trace has completed, the execution of the user code will 
be temporarily stopped. Use the "display" command to look at the 
memory locations starting at 2000h in a blocked words format. You 
will notice that you stopped the Towers of Hanoi program as it was 
playing the game of moving the discs from one set of memory locations 
(or pegs) to another. By breaking into the monitor instead of using 
the reset feature, you have also saved the program counter. 

[ ] Enter the following commands and see what happens! 

display memory 2000h repetitively blocked words 
run 

You will notice that the game has started by placing all the discs 
on the top "peg". You happened to have used the trace command as 
to catch the user program initializing the game. You should also 
notice that using the "break on trigger" specification is very 
helpful to "freeze" your program. What a debugging feature! 
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Display / Modify features 

[ ] You have already been introduced to the display registers , display 
memory and display trace commands, but you haven't yet noticed the 
different formats which are available. Take some time to read 
the help message on "display" and then play with displaying data in 
different formats. (10 minutes). 

[ ] You also have the ability to modify both the registers and memory 
locations. Normally the only problems you have when modifying 
memory are associated with modifying ROM locations and guarded 
memory. Modify the emulation configuration and ADD a section of 
memory which is ROM. Try to modify and display these locations 
and see what happens. You should be able to modify these locations 
if they are mapped to emulation, but never if they were mapped to 
target. 

[ ] The next display feature would be displaying symbols. The first 
one you should try is global symbols. Determine how to do this 
using the help facilities. 

[ ] Another display option as far as symbols are concerned is being 
able to display local symbols. Use the help facilities to display 
the local symbols in the module "pause. P". You will have to use 
the syntax "display localsymbolsin <source filename>:". 

[ ] Take notice of the symbol "DELAY". You can use this information 
for symbolic debugging. For instance, setup a trace specification 
to trigger about the detection of the DELAY symbol and have the 
analyzer break into the monitor. Display the trace data with the 
option for source code turned on in inverse video. You will see 
that the source line referencing feature of 64000-UX can be very 
helpful, because you can see the high-level source shown with the 
disassembled absolute code together in one listing. 
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Tracing 

[ ] The biggest feature of emulation is that it is coupled with the 
internal analyzer (emulation bus analyzer) as one module. In this 
role, the analyzer can be used as a major debugging tool for the 
user. The feature set of the internal analyzer is quite large and 
extensive. BRIEFLY read the help information on the trace command 
to get an idea of this feature set. The flexibility of the analyzer 
manifests itself in the trace specifications and display options. 
Take about 30 minutes to get a feel for what the analyzer can do, 
especially the "trace only" option. 

[ ] You will notice that three different data types can be traced upon. 
These include address, data, and status. In conjunction with these 
features, you can specify "do^t care conditions" for the trace 
specification. Try out this feature of the analyzer. The "don f t 
care" character that should be used is an "x". Ask the instructor 
for help if this is not clear. 

[ ] One neat example of the flexibility of the analyzer is to trace 
looping routines used as timing loops in software. As am example, 
display the local symbols of the pause .P module again and take note 
of the symbols. If you were to trace the OUTER COUNT label and 
then display the trace using a count relative format, you can get 
an idea of how long this pause routine takes. HINT: the trick to 
doing this measurement is to use the "only" specification in the 
trace. You should get an answer of about 4.006 mS for the outer 
loop to execute. This would mean that the pause routine would 
take about 500 times that long to complete, because of the DELAY 
variable. 

Exiting Emulation 

[ ] Exit the emulation session by "end releasing" the system. If you 
did an msstat, you would see that the emulator is now available 
for use by other students. 
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HP 64000-UX Emulation Lab (Part 2) 

Objectives: 

* debugging with emulation and the internal analyzer 



Prepare absolute code 

[ ] Make sure you are in pmon. 

[ ] A command file for compiling all of the necessary files has been 
provided for you. Take a look at comp_hanoi_l . 

[ ] Edit this file and add the two lines shown below. If command files 
are used, they will normally contain the linker command as well as 
the assembler / compiler commands. TAKE NOTE: the "edbuild" 
command is included here so that it doesn't have to be generated 
when entering emulation. This is usually a good idea so that you 
are not forced to wait for your code to compile and link and then 
wait for the symbol database to be built at a different time. 

Ink -ox alll.K > main. map 
edbuild main 

[ ] Execute the comp hanoil command file from within pmon and verify that 
it executed without any problems. 
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Emulation and Debugging 

[ ] Enter the emulator loading the emulation configuration used earlier 
as well as the new absolute (main.X). Repetitively display memory 
starting at 2000h and run the user code from the transfer address. 
Be sure to use the "blocked words 11 option to the display command. 

Did you notice any problems? 

These are the problems that you must fix. First, you noticed that 
the data structure for one of the discs is incorrect. Secondly , you 
may have noticed that the program does not appear to be running 
correctly. 

HINTS: if you were the author of this code you would that the data 
structure for this programs was loaded around 021A0h. You should also 
notice that all the appropriate discs are showing up on the display 
memory, it just appears that they are being put in the wrong 
locations. Upon a closer examination you may notice that the program 
seems to be functioning properly as far as where it stacks the discs 
and how it stacks them. 

Fix the code such that you can see the program play the game 
properly with a "display memory 2000h repetitively blocked words". 

Good Luck! ! 



Extra Credit: 

If you are feeling confident about your skills with the emulator 
and analyzer, try running the command file called: comphanoi 2 . 
Edit this file and add the linker command and the edbuild command. 

If you don't find that much of a challenge, the run the command file 
called: comp_hanoi_3 . Don't forget to add the linker command and 
edbuild command to the command file. 
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LOGIC SYSTEMS DIVISION 

Products 

• Teamwork SA/SD/RT 

• C and Pascal Compilers 

• Cross assemblers/linkers 

• Emulators 

• State analyzers 

• Timing analyzers 

• Software performance analyzers 

• Prom programmers 
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NOTES: 

Your HP sales representative (FE) can give you a complete breakdown of all the products produced and sold 
by Logic Systems Division. 

STUDENT NOTES: 
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Logic Systems Division - Training Plan 



HP 64000-UX Overview Structured Methods (SA, SD) 



Troubleshooting 
(64000 & Options) 



HP 64000 Plus/VMS 
Installation and Service 



HP 64000 Plus/UX 
Installation and Service 



Installation/Service 



Language System Emulation/Analysis 
(300, 302) Sim I/O, 
PROM Prog. 




HP-UX User 
Training 



HP-UX System 
Admin 



HP 9000 
Networking 



Teamwork (SA, SD) 



Structured Methods 
Analysis 11,1MB User-Definable 32-bit Emulation/ (RT) 
(310,601,620, Tools ROM Emul Analysis I 
Spider,Soda) I 

Teamwork (RT) 



Micro-Program Tools 



Systems 



HP 64000 Overview (VAX) 
Features 



CASE 
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NOTES: 



This slide diagram shows the training classes which are currently available or will be available for customers 
As you will see, this overview course is only the first of many courses you may elect to take in a variety <>l 
subject areas. 



STUDENT NOTES: 
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COURSE CONCLUSION 

Objectives 

• Familiarity with HP-UX as an operating system 

• Familiarity with HP 9000 Series 300 hardware 

• Knowledge of extensive features of HP-UX 

• How to build, manage, and move around in your 

file system 

• Purpose and requirements of a system adiministrator 
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Getting Started With HP-UX 
□ Course Conclusion 

. . . 



COURSE CONCLUSION 



What This Course Introduced: 
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STUDENT NOTES: 
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Getting Started Wit h HP-UX 



□ Course Conclusion 



COURSE CONCLUSION 

Knowledge Survey 

• Determine knowledge level of student 

- before course 

- after course 

• Use as feedback mechanism for course improvement 

• The student MUST be objective! 
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